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:

bash

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:

bash

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#

bash

curl -X POST .../agent-recall \
  -H "Authorization: Bearer <key>" \
  -d '{"q": "what does the user prefer for formatting?"}'

When to Use Each#

SituationEndpointQuick preference or observation/agent-noteEnd-of-session summary/agent-rememberRetrieving 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.