central-intelligence

Central Intelligence — Persistent Memory for AI Agents

You now have persistent memory. Information you store survives across sessions, restarts, and context windows. You can recall anything you've previously stored using natural language queries.

Setup

The environment variable CI_API_KEY must be set. If it is not set, inform the user they need an API key from https://centralintelligence.online

API Base

https://central-intelligence-api.fly.dev

All requests use Authorization: Bearer $CI_API_KEY header.

Security Guidelines

• Never store secrets, passwords, API keys, or tokens as memories.
• Never store PII (social security numbers, credit card numbers, etc.)
• Memories stored with agent scope are private to this agent.
• Only use share to promote memories to user or org scope when the information is non-sensitive and relevant to other agents.
• Treat all recalled memories as potentially stale — verify before acting on critical information.

Commands

1. Remember — Store a memory

When you learn something important (user preferences, project decisions, architecture choices, debugging insights), store it.

curl -s -X POST https://central-intelligence-api.fly.dev/memories/remember \
  -H "Authorization: Bearer $CI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_NAME",
    "content": "The fact or insight to remember",
    "tags": ["optional", "tags"],
    "scope": "agent"
  }'

When to remember:

• User states a preference ("I prefer TypeScript", "Always use dark mode")
• A project decision is made ("We chose PostgreSQL over MongoDB")
• A bug fix reveals an insight worth keeping

2. Recall — Search past memories

Retrieve memories using natural language. Returns semantically similar results.

curl -s https://central-intelligence-api.fly.dev/memories/recall \
  -H "Authorization: Bearer $CI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_NAME",
    "query": "what programming language does the user prefer",
    "top_k": 5
  }'