by edwin-hao-ai
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.
# Add to your Claude Code skills
git clone https://github.com/edwin-hao-ai/Awareness-LocalGive 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/setup
That'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 |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
| | ✅ | via MCP |
No comments yet. Be the first to share your thoughts!
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:
npx @awareness-sdk/setup --cloud
# Or click "Connect to Cloud" in the dashboard
Awareness 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
No Python, no Docker, no cloud account needed.
Apache 2.0