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 \x3Ckey>" \
  -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 \x3Ckey>" \
  -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 \x3Ckey>" \
  -d '{"q": "what does the user prefer for formatting?"}'

When to Use Each

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.