Docs

Use caveauMEM from agents.

caveauMEM exposes a REST API and an MCP HTTP adapter for tool discovery and tool calls. Public GitHub material covers docs, SDK examples, provider examples, local demo, and community-safe core.

Licensing split

Community-safe core and examples: Apache-2.0. Hosted SaaS, billing automation, managed appliance tooling, license enforcement, and support automation: commercial/proprietary.

Connect in one command

The quickest way to point Claude Code, VS Code or Codex at your memory. It signs you in through Blue Note ID in the browser, resolves your tenant, and writes the config for you — no token to copy.

npx @bluenotelogic/harness init

Nothing secret is written

The `.mcp.json` it produces carries no token. OAuth-capable hosts hold their own credentials, so the file is safe to commit alongside your code.

Headless and SSH

`--device` uses the RFC 8628 device-code flow for machines that cannot open a browser. `--codex` also configures Codex. `--dry-run` shows every file it would touch and writes nothing.

Hosts that cannot do OAuth

`--mint-token` additionally issues a short-lived `cmem_` token for clients that only speak bearer auth — the manual path documented below.

HTTP MCP adapter

Expose `/mcp` only through explicit Apache or Caddy routing to `api/mcp/index.php`. The public webroot remains `public/`.

POST /mcp
Authorization: Bearer cmem_...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": "list-1",
  "method": "tools/list"
}

Durable save/recall

`persistent_save` and `persistent_recall` handle long-lived semantic and procedural memory.

Scratch and episodic

`scratch_set`, `scratch_get`, `episodic_log`, and `episodic_recall` cover active work and session history.

Learning loop

`feedback_file` and `proposal_create` keep memory correction human-reviewed.

Agent patterns

Integration	Launch guidance	Status
Claude/Codex	Recall at session start, enrich instructions with scoped context, log post-turn summaries.	Beta ready
Hermes	Use one scoped token per agent and namespace. No admin tokens in agent processes.	Beta until provider registration verified
Voice agents	Pre-call recall, mid-call scratch, post-call episodic log, staged durable writes after review.	Guide ready
iCal	Todo/episodic bridge for due dates and calendar exports.	Planned