Local-first by default
Markdown on the user machine, local index, no account required. Cloud sync is optional.
Protocol · v0.1 draft
Awareness Memory Protocol (AMP/0.1) defines four memory operations over MCP: init, recall, record, and lookup. Local-first by default, explicit scopes, lossless export, and a documented cloud boundary.
Why a protocol
Today, every memory product stores context in its own way. A team that switches IDE or agent loses the accumulated decisions. AMP/0.1 is a narrow contract: four operations, a portable data model, and an export format. It is not a new agent runtime and not a vector database standard.
Markdown on the user machine, local index, no account required. Cloud sync is optional.
Any MCP client can use the same memory: Claude Code, Cursor, Codex, Windsurf, Cline, Copilot, Zed, JetBrains, OpenClaw.
Knowledge cards, tasks, skills, graph facts, and rules are first-class, not an afterthought.
Lossless export as Markdown + JSON; import is a first-class operation.
Explicit scopes; no secrets in memory; cross-scope recall requires authorization.
The four operations
Load the minimum context for a session: rules, open tasks, knowledge summaries, skills, and the agent profile. Idempotent per workspace and scope.
Retrieve relevant memory with hybrid, precise, session, structured, or auto modes. Zero LLM calls; summaries by default, full content on request.
Write a memory, a batch, a backfill, an ingest, a task update, or structured insights. Conflicts are returned explicitly, never silently overwritten.
Fast structured lookup for tasks, rules, history, timeline, handoff, graph, and agents. Use recall for ranking; use lookup for exact fields.
Boundary
Local mode works without an account and without a network connection. Cloud sync is opt-in; when enabled, it is a replica, not the only copy. The spec requires explicit scopes, lossless export, and tenant isolation in conforming cloud implementations. Secrets are out of scope.
The local daemon and MCP server are open source in Awareness-SDK.
View the implementationLongMemEval-S methodology, limits, and reproduction steps.
Read the system cardChallenge the scope model, the export format, or the graph schema.
e@awareness.marketLocal-first, no account, no credit card. Start in 30 seconds and keep the data on your machine.