Awareness Local — Claude Code MCP server: setup
A local MCP server keeps decisions and project context across AI coding sessions. Use it for migrations, handoffs, and workflows that span multiple sessions.
claude mcp add awareness-local -- npx -y @awareness.market/localWhat Awareness Local does
Awareness Local gives an AI coding agent persistent memory between sessions. It writes decisions, discovered solutions, pending work, and implementation constraints to Markdown files under .awareness/, then retrieves relevant context with a mix of keyword and semantic search.
A local daemon handles the memory flow. Its index uses SQLite FTS5 and embeddings, while retrieval runs without LLM calls. Local mode works offline and does not require a cloud account. The server is launched through npx, so setup starts with an MCP registration command.
The local daemon is part of the runtime: it stores the memory on your machine and exposes tools for recording, recalling, and initializing sessions.
What it helps with
- carry architecture decisions across agent sessions
- resume a codebase migration with prior context
- share implementation history during team handoffs
- retain coding preferences and project conventions
Example prompts for the agent
- Save the current architecture decision to project memory and explain its rationale.
- Search memory for earlier decisions about this migration before changing the code.
- Initialize this session and bring back pending tasks and project constraints.
How to install Awareness Local
Platform CLI
claude mcp add awareness-local -- npx -y @awareness.market/localPlatform CLI
codex mcp add awareness-local -- npx -y @awareness.market/localConfig file
{
"mcpServers": {
"awareness-local": {
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Config file
{
"servers": {
"awareness-local": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Platform CLI
gemini mcp add awareness-local npx -y @awareness.market/localStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Awareness Local
How do I install Awareness Local in Claude Code?
Run claude mcp add awareness-local -- npx -y @awareness.market/local.
What does Awareness Local do?
It stores an AI coding agent’s project memory as Markdown and retrieves relevant context with keyword and semantic search. This carries decisions and tasks into later sessions.
Can Awareness Local work offline?
Yes. Local mode keeps memory on the machine and does not require a cloud account.
