Memory

bluecolumn-memory

Give AI agents persistent semantic memory using the BlueColumn API (bluecolumn.ai). Use when asked to remember, store, recall, or search memory using BlueColumn; when ingesting notes, conversations, documents, or audio into BlueColumn; when querying what an agent has previously stored; or when wiring up BlueColumn memory endpoints (/agent-remember, /agent-recall, /agent-note) in any workflow. Also use when the user mentions their BlueColumn API key (bc_live_*) and wants to store or retrieve information.

What it does

The skill document

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 " \
  -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 " \
  -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 " \
  -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.

Related skills

documentation-memory

Give AI agents Remember docs you've written and read. using BlueColumn persistent memory. Use when an agent maintains documentation and needs to reuse it; when the user wants to store, recall, or search documentation memory context. Requires a BlueColumn API key (bc_live_*).

content-memory

Give AI agents Remember content ideas and drafts. using BlueColumn persistent memory. Use when an agent supports content creation and needs idea continuity; when the user wants to store, recall, or search content memory context. Requires a BlueColumn API key (bc_live_*).

meeting-memory

Give AI agents Every meeting becomes searchable. using BlueColumn persistent memory. Use when an agent takes meeting notes and needs recall; when the user wants to store, recall, or search meeting memory context. Requires a BlueColumn API key (bc_live_*).

13 installs

coaching-memory

Give AI agents Track goals and coaching progress. using BlueColumn persistent memory. Use when an agent coaches users and tracks progress; when the user wants to store, recall, or search coaching memory context. Requires a BlueColumn API key (bc_live_*).

streaming-audio-memory

Ingest live edge-device audio (car, doorbell, wearable, kiosk) into per-device streaming memory and recall what a device heard. Use when an agent streams audio chunks from devices, monitors ambient audio, or answers questions about a device's audio history. Requires a BlueColumn API key (bc_live_*).

journal-memory

Give AI agents Store every thought as searchable memory. using BlueColumn persistent memory. Use when an agent keeps a journal and needs to revisit entries; when the user wants to store, recall, or search journal memory context. Requires a BlueColumn API key (bc_live_*).