Agent Journal Skill
Persistent cross-session journal for AI agents. Store observations, preferences, and decisions — recall them anytime.
Setup
Read TOOLS.md for the BlueColumn API key (bc_live_*). Keys are generated at bluecolumn.ai/dashboard. Store securely — never log or expose them.
Base URL: https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1 (BlueColumn's official backend — bluecolumn.ai runs on Supabase Edge Functions)
Log an Observation (agent-note)
For lightweight agent observations — preferences, patterns, decisions:
curl -X POST .../agent-note \
-H "Authorization: Bearer <key>" \
-d '{"text": "User prefers bullet points over paragraphs", "tags": ["preference", "style"]}'
Log a Detailed Entry (agent-remember)
For richer entries with auto-extracted metadata:
curl -X POST .../agent-remember \
-H "Authorization: Bearer <key>" \
-d '{"text": "Session summary: user is building a SaaS product in Phoenix. Decided on PostgreSQL. Main concern is scalability.", "title": "Session Log 2026-04-14"}'
Recall Journal Entries
curl -X POST .../agent-recall \
-H "Authorization: Bearer <key>" \
-d '{"q": "what does the user prefer for formatting?"}'
When to Use Each
| Situation | Endpoint |
|---|
| Quick preference or observation | /agent-note |
| End-of-session summary | /agent-remember |
| Retrieving past context | /agent-recall |
Journaling Workflow
Start of session: Recall relevant context:
- "What do I know about this user?"
- "What were we working on last time?"
During session: Note important observations via /agent-note
End of session: Summarize and store via /agent-remember
Tag Suggestions
preference — user style/format preferences
decision — architectural or product decisions
context — background info about user/project
followup — things to revisit
See references/api.md for full API reference.