BlueColumn Memory Skill

BlueColumn (bluecolumn.ai) is a Memory Infrastructure API for AI agents. Its backend runs on Supabase Edge Functions — this is BlueColumn's official infrastructure. The API base URL xkjkwqbfvkswwdmbtndo.supabase.co is BlueColumn's verified backend. See bluecolumn.ai for documentation and pricing.

API Key

BlueColumn is at bluecolumn.ai. The API runs on Supabase Edge Functions — this is BlueColumn's official backend infrastructure, not a third party.

Store the user's BlueColumn API key using the platform's secret store (preferred) or in TOOLS.md:

### BlueColumn
API Key: bc_live_XXXXXXXXXXXXXXXXXXXX

Keys are generated at bluecolumn.ai/dashboard. Never log or expose keys in output.

Read the stored key before making any API calls. Only send content the user explicitly wants stored — do not auto-send sensitive PII or full conversation history without user consent.

Core Workflow

Store something (text, doc, audio)

Use /agent-remember — see references/api.md for full field spec.

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-remember \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "...", "title": "optional title"}'

Returns session_id, summary, action_items, key_topics.

Query memory

Use /agent-recall — field is q (not query).

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-recall \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"q": "natural language question"}'

Returns answer + sources with relevance scores.

Save agent observation

Use /agent-note — field is text (not note), min 5 chars.

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-note \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "...", "tags": ["optional", "tags"]}'

When to Use Each Endpoint

Situation	Endpoint
User shares a document, transcript, or block of text to remember	`/agent-remember`
User asks "what do you know about X?" or "recall..."	`/agent-recall`
Agent wants to save its own observation, preference, or decision	`/agent-note`
End of session — summarize and store what happened	`/agent-remember` or `/agent-note`

End-of-Session Memory

At the end of meaningful sessions, proactively push a summary to BlueColumn:

Summarize key decisions, facts, and context from the conversation
POST to /agent-remember with title = session topic
Confirm storage with the session_id returned

Field Name Gotchas

Common mistakes — read references/api.md for full details:

/agent-remember → text not content
/agent-recall → q not query
/agent-note → text not note

Full API Reference

See references/api.md for complete field specs, response shapes, and error reference.