Your AI agent never forgets.
A complete memory system for AI coding agents in a single markdown file. Your agent never forgets.
v3.5 · ⬇ 0 · Updated July 6, 2026
The problem
Every AI coding session starts from zero. Your agent forgets yesterday's decisions, re-researches what it already learned last month, contradicts choices it made last week, and repeats mistakes it already fixed in another project. Context compacts; knowledge evaporates.
The fix
SYNAPSE is a complete memory system in a single markdown file. Give the file to your agent — that's the whole install. It builds local memory per project, a global brain shared across all your projects, and a nightly sleep cycle that keeps everything fresh, deduplicated and contradiction-free.
The cognitive engine
Two-level memory
Local memory per project — working state, dated decisions, session archives — plus a global brain shared across ALL your projects. Knowledge learned once, available everywhere.
Nightly sleep cycle
A headless consolidation pass compresses, deduplicates, detects contradictions and promotes reusable learnings — every night, off your working sessions.
Memory budget
You choose how much auto-loads per session: from a 2k-token index up to full total recall — your entire brain in context. Real cost shown before you choose.
Freshness decay
Every fact carries a verification date. Aging knowledge gets flagged for re-verification instead of silently rotting — no more confidently citing March pricing in July.
Hebbian reinforcement
Notes that actually get used grow stronger; unused ones fade to the attic (still greppable). What fires, wires.
Golden references
Mark your best work. Golden notes are never evicted, always hot, and become the default blueprint whenever you build something similar.
Portable mode
Works with Cursor, Codex CLI, Gemini CLI, Windsurf… All agents share the same brain — knowledge learned in Claude is available in Cursor, and vice versa.
Privacy by design
Plain markdown on your machine. No cloud, no database, no telemetry. Secrets and personal identifiers are never stored — a hard rule, not a setting.
Install in one gesture
Claude Code
Download SKILL.md and drag it into any Claude Code conversation. Say nothing else — Claude installs everything itself (~40 seconds) and reports back. Or from the terminal:
mkdir -p ~/.claude/skills/synapse && curl -fsSL https://raw.githubusercontent.com/ANTHO56200/synapse-memory/main/SKILL.md -o ~/.claude/skills/synapse/SKILL.mdthen open Claude Code in any project and say: "set up SYNAPSE".
Any other AI agent — portable mode
Give the file to Cursor, Codex CLI, Gemini CLI, Windsurf… and say: "Read this file and set up SYNAPSE portable mode." All agents share the same brain.
What you get
| Command | What it does |
|---|---|
| /brief | Where were we? 5-line project status on demand |
| /brief full | Complete State of the Union of both memory levels |
| /recall <topic> | Search ALL memory across ALL projects, with freshness warnings |
| /decision <what> | Log a dated decision, auto-checked for contradictions |
| /learn <insight> | Promote reusable knowledge to the global brain |
| /forget <topic> | Clean removal — soft by default, restorable from the attic |
| /memory-map | Visual HTML dashboard of everything your agent knows |
| /memory-budget | Choose how much memory auto-loads per session |
| /consolidate | Run the sleep cycle right now |
| /memory-doctor | Memory health score /100 + auto-fixes |
Plus the automatic part: memory auto-loads at every session start, a pre-compaction hook saves state before context loss, and the session brief warns you about conflicts and stale knowledge.
See everything your agent knows
Frequently asked questions
Where exactly is my data?
~/.claude/brain/ (global brain) + <project>/.claude/memory/ (local memory). Everything is plain markdown on your machine. Delete those folders and SYNAPSE is gone.
Does SYNAPSE send my data anywhere?
No. No cloud, no database, no MCP server, no telemetry. Secrets, tokens, .env values and personal identifiers are never stored — a hard rule in the protocol, not a setting.
What does it cost per session?
Your choice, price shown upfront: lean is about 1-2k tokens, pro 3-8k, deep 10-40k, and full total recall loads your entire brain (typically 50-150k once mature). Set at install, resize anytime with /memory-budget. Only the auto-load is capped; storage is unlimited.
Does it work with agents other than Claude Code?
Yes — portable mode. Give the file to Cursor, Codex CLI, Gemini CLI or Windsurf and say: "Read this file and set up SYNAPSE portable mode." All agents share the same brain.
Can I use it on multiple machines?
Yes. Make ~/.claude/brain/ a private git repo — the file tells your agent how.
How do I uninstall?
Ask your agent to "uninstall SYNAPSE" — the file documents complete removal, with an export offered first.
If SYNAPSE saved your context, a ⭐ helps others find it.
Star on GitHub
We're developers and SaaS builders who use these tools daily in production. Every review comes from hands-on experience building real products — DealPropFirm, ThePlanetIndicator, PropFirmsCodes, and many more. We don't just review tools — we build and ship with them every day.
Written and tested by developers who build with these tools daily.