Protocol · v0.1 draft

A small, open memory protocol for AI agents.

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

Memory should outlive the agent.

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.

Local-first by default

Markdown on the user machine, local index, no account required. Cloud sync is optional.

Agent-agnostic

Any MCP client can use the same memory: Claude Code, Cursor, Codex, Windsurf, Cline, Copilot, Zed, JetBrains, OpenClaw.

Structured, not just vector

Knowledge cards, tasks, skills, graph facts, and rules are first-class, not an afterthought.

No lock-in

Lossless export as Markdown + JSON; import is a first-class operation.

Least privilege

Explicit scopes; no secrets in memory; cross-scope recall requires authorization.

The four operations

Init. Recall. Record. Lookup.

01

awareness_init

Load the minimum context for a session: rules, open tasks, knowledge summaries, skills, and the agent profile. Idempotent per workspace and scope.

02

awareness_recall

Retrieve relevant memory with hybrid, precise, session, structured, or auto modes. Zero LLM calls; summaries by default, full content on request.

03

awareness_record

Write a memory, a batch, a backfill, an ingest, a task update, or structured insights. Conflicts are returned explicitly, never silently overwritten.

04

awareness_lookup

Fast structured lookup for tasks, rules, history, timeline, handoff, graph, and agents. Use recall for ranking; use lookup for exact fields.

Boundary

Local is the default. Cloud is a replica.

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.

Feedback

Challenge the scope model, the export format, or the graph schema.

e@awareness.market

Give your agent a memory that compounds.

Local-first, no account, no credit card. Start in 30 seconds and keep the data on your machine.