edwin-hao-ai

edwin-hao-ai / Awareness-Local

Public

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.

ai-agent ai-memory claude-code cursor llm
12
0
100% credibility
Found Mar 28, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

Awareness Local provides a local memory system for AI coding agents in various IDEs, storing human-readable notes of sessions, decisions, and tasks to enable persistence across uses.

How It Works

1
💡 Discover lasting memory for AI helper

You hear about a simple tool that lets your AI coding assistant remember conversations, decisions, and tasks from one session to the next, so no more repeating yourself.

2
🚀 Start with one easy command

You type a single quick command on your computer, and the memory system sets itself up in seconds without needing any accounts or internet.

3
✨ AI connects automatically

Your coding app detects the memory helper and links up right away, ready to save and recall everything you work on.

4
🖥️ Work in your coding space

As you chat with your AI, it saves key insights, decisions, and unfinished tasks into easy-to-read notes.

5
📱 View your memories

Open a simple web page on your computer to browse, edit, or manage all the saved memories, tasks, and knowledge.

🎉 Seamless ongoing work

Next time you open your coding app, your AI remembers exactly where you left off, like 'Last time we chose this option and had two tasks remaining—let's continue!'.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Awareness-Local?

Awareness Local is a JavaScript daemon that adds persistent memory to local-first AI agents, so your Claude Code, Cursor, or Windsurf setups remember decisions across sessions without re-explaining everything. Run one command—`npx @awareness-sdk/setup`—and it stores memories as editable Markdown files with hybrid FTS5 keyword plus embedding search, exposes tools via MCP protocol on localhost:37800, and offers a web dashboard at http://localhost:37800/. No account, fully offline, git-friendly storage in .awareness/.

Why is it gaining traction?

It hooks developers tired of agents starting from scratch by auto-recalling context like "we chose PostgreSQL last time, two TODOs left," using progressive disclosure to feed only relevant summaries first, saving tokens. Stands out from cloud memory tools with zero-account local-first setup, broad MCP support for 13+ IDEs like OpenClaw and Zed, and optional cloud sync. Markdown output means human-readable awareness local logs you can version control.

Who should use this?

Backend devs migrating schemas in Cursor who hate repeating framework choices. AI agent tinkerers in Claude Code or Windsurf building multi-session prototypes. Local-first agent users avoiding vendor lock-in for code tasks, knowledge cards, and open tasks.

Verdict

Worth a quick `npx` test for MCP-compatible IDEs if you need offline agent memory—docs are solid, setup is dead simple. But 12 stars and 1.0% credibility score signal early immaturity; monitor for stability before production.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.