edwin-hao-ai/Awareness-Local
Local-first AI agent memory — one command, works offline, no account needed. Give your Claude Code, Cursor, Windsurf, OpenClaw agent persistent memory. Markdown storage, hybrid search (FTS5 + embedding), MCP protocol, Web dashboard.
Platform-specific configuration:
{
"mcpServers": {
"Awareness-Local": {
"command": "npx",
"args": [
"-y",
"Awareness-Local"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
Give your AI agent persistent memory. One command. No account. Works offline.
Awareness Local is a local-first memory system for AI coding agents. It runs a lightweight daemon on your machine that stores memories as Markdown files, searches with hybrid FTS5 + embedding, and connects to any IDE via the MCP protocol.
npx @awareness-sdk/setupThat's it. Your AI agent now remembers everything across sessions.
---
Before: Every session starts from scratch. You re-explain the codebase, re-justify decisions, watch the agent redo work.
After: Your agent says *"I remember you were migrating from MySQL to PostgreSQL. Last session you completed the schema changes and had 2 TODOs remaining..."*
Session 1 Session 2
┌─────────────────────────┐ ┌─────────────────────────┐
│ Agent: "What database?" │ │ Agent: "I remember we │
│ You: "PostgreSQL..." │ │ chose PostgreSQL for │
│ Agent: "What framework?"│ → │ JSON support. You had │
│ You: "FastAPI..." │ │ 2 TODOs left. Let me │
│ (repeat every session) │ │ continue from there." │
└─────────────────────────┘ └─────────────────────────┘---
| IDE | Auto-detected | Plugin | |-----|:---:|:---:| | Claude Code | ✅ | `awareness-memory` | | Cursor | ✅ | via MCP | | Windsurf | ✅ | via MCP | | OpenClaw | ✅ | `@awareness-sdk/openclaw-memory` | | Cline | ✅ | via MCP | | GitHub Copilot | ✅ | via MCP | | Codex CLI | ✅ | via MCP | | Kiro | ✅ | via MCP | | Trae | ✅ | via MCP | | Zed | ✅ | via MCP | | JetBrains (Junie) | ✅ | via MCP | | Augment | ✅ | via MCP | | AntiGravity (Jules) | ✅ | via MCP |
---
Your IDE / AI Agent
│
│ MCP Protocol (localhosLoading reviews...