Awareness Local
Local-first persistent memory for coding agents, stored as Markdown on your machine
- Pricing
- Freemium
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.21.1
- Listing updated
- 2 days ago
About Awareness Local
Awareness Local is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Awareness stores decisions, solutions, risks and preferences as plain Markdown in a .awareness folder, indexes them with SQLite FTS5 plus embeddings, and recalls them in later sessions of Cursor, Claude Code, Copilot, Cline, Windsurf and other MCP clients. A single command, npx @awareness.market/setup, installs a lightweight local daemon and writes the MCP config and workflow rules so the agent knows when to recall and record.
Retrieval combines keyword, vector and knowledge-graph search without LLM calls. The project reports 96.0% Recall@5 on the LongMemEval benchmark over its 500 questions and says scripts to reproduce it are included. It also claims around 60% fewer context tokens through compression. These are the vendor's own figures. It runs fully offline with no account; ChatGPT Desktop can connect to the local daemon at http://127.0.0.1:37800/mcp.
Cloud sync is optional and adds team sharing, semantic search and multi-device access. The pricing page positions it as a memory database rather than an agent runtime or general vector database.
Install
Run in a terminal
claude mcp add awareness-local -- npx -y @awareness.market/localAdd to claude_desktop_config.json
{
"mcpServers": {
"awareness-local": {
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"awareness-local": {
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"awareness-local": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"awareness-local": {
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"awareness-local": {
"command": "npx",
"args": [
"-y",
"@awareness.market/local"
]
}
}
}What it does
- Markdown memory
- Memories are plain files in .awareness with a local SQLite index.
- Hybrid recall
- Keyword, vector and graph retrieval with no LLM calls.
- One-command setup
- npx @awareness.market/setup configures MCP and rules.
- Knowledge cards
- Extracts decisions, solutions and risks as structured records.
- Offline use
- Works without an account or network.
- Optional cloud sync
- Add team sync and multi-device access when needed.
Good for
- Keep context across long codebase migrations
- Hand off project knowledge between teammates' agents
- Retain coding conventions and preferences between sessions
- Share decision history among several agents
Pricing
Freemium
Free plan; Team adds 5 seats and 500K calls a month; Enterprise by arrangement
Prices change. Check awareness.market before you buy.
Awareness Local FAQ
Does it work offline?
Yes. Local mode works fully offline with data on your machine.
Do I need an account?
No. Cloud sync is optional.
What does the free plan include?
One memory library, one seat, 1,000 API calls a month and 100 MB of storage.
Where is data kept?
As Markdown in .awareness, with a local SQLite index.
Is Awareness Local free?
Awareness Local has a free plan, with paid plans for more usage or features.
How do I add Awareness Local to Claude Code?
Run this command in your terminal: claude mcp add awareness-local -- npx -y @awareness.market/local
What are the best alternatives to Awareness Local?
The closest alternatives to Awareness Local are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Awareness Local

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools