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 (localhost:37800)
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Awareness Local Daemon โ
โ โ
โ Markdown files โ Human-readable, git-friendly
โ SQLite FTS5 โ Fast keyword search
โ Local embedding โ Semantic search (optional: npm i @huggingface/transformers)
โ Knowledge cards โ Auto-extracted decisions, solutions, risks
โ Web Dashboard โ http://localhost:37800/
โ โ
โ Cloud sync (optional) โ
โ โ One-click device-auth โ
โ โ Bidirectional sync โ
โ โ Semantic vector search โ
โ โ Team collaboration โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
All memories stored as Markdown files in .awareness/ โ human-readable, editable, git-friendly:
.awareness/
โโโ memories/
โ โโโ 2026-03-22_decided-to-use-postgresql.md
โ โโโ 2026-03-22_fixed-auth-bug.md
โ โโโ ...
โโโ knowledge/
โ โโโ decisions/postgresql-over-mysql.md
โ โโโ solutions/auth-token-refresh.md
โโโ tasks/
โ โโโ open/implement-rate-limiting.md
โโโ index.db (search index, auto-rebuilt)
| Tool | What it does |
|---|---|
awareness_init |
Load session context โ recent knowledge, tasks, rules |
awareness_recall |
Search memories โ progressive disclosure (summary โ full) |
awareness_record |
Save decisions, code changes, insights โ with knowledge extraction |
awareness_lookup |
Fast lookup โ tasks, knowledge cards, session history, risks |
awareness_get_agent_prompt |
Get agent-specific prompts for multi-agent setups |
Instead of dumping everything into context, Awareness uses a two-phase recall:
Phase 1: awareness_recall(query, detail="summary")
โ Lightweight index (~80 tokens each): title + summary + score
โ Agent reviews and picks what's relevant
Phase 2: awareness_recall(detail="full", ids=[...])
โ Complete content for selected items only
โ No truncation, no wasted tokens
Visit http://localhost:37800/ to browse memories, knowledge cards, tasks, and manage cloud sync.
Connect to Awareness Cloud for:
- Semantic vector search (100+ languages)
- Cross-device real-time sync
- Team collaboration
- Memory marketplace
npx @awareness-sdk/setup --cloud
# Or click "Connect to Cloud" in the dashboardAwareness Local is part of the Awareness ecosystem:
| Package | For | Install |
|---|---|---|
| Awareness Local | Local daemon + MCP server | npx @awareness-sdk/setup |
| Python SDK | wrap_openai() / wrap_anthropic() interceptors |
pip install awareness-memory-cloud |
| TypeScript SDK | wrapOpenAI() / wrapAnthropic() interceptors |
npm i @awareness-sdk/memory-cloud |
| OpenClaw Plugin | Auto-recall + auto-capture | openclaw plugins install @awareness-sdk/openclaw-memory |
| Claude Code Plugin | Skills + hooks | /plugin marketplace add edwin-hao-ai/Awareness-SDK โ /plugin install awareness-memory@awareness |
| Setup CLI | One-command setup for 13+ IDEs | npx @awareness-sdk/setup |
Full SDK docs: awareness.market/docs
- Node.js 18+
- Any MCP-compatible IDE
No Python, no Docker, no cloud account needed.
Apache 2.0