BrainSync
Your AI agents forget everything between sessions. BrainSync makes them remember.
🚀 Never Miss a Fix
BrainSync ships critical fixes & new features every day.
Don't get left behind on a broken version.
Antigravity / VS Code / Cursor / Windsurf etc:
Settings → Extensions → Auto Update → ✅ Enable
Antigravity IDE:
Already auto-updates! ✅
|
💬 Join the Inner Circle
Get early access to features, vote on the roadmap, and get direct support from the creator.
Members get priority bug fixes & feature requests.
|
🧠 Live Memory Dashboard

152K tokens optimized. 5.4 hours saved. 93 observations captured. All automatic.
📜 Recent Activity Feed

Every change — file saves, MCP calls, fixes — captured with category tags and timestamps.
🤖 Auto-Generated Skills + Custom Skills

BrainSync auto-compiles patterns into reusable skills. Create custom skills for design systems, API conventions, and more. Toggle on/off per category.
⚠️ Gotchas + Observation Detail

Color-coded by category. Full context. Never make the same mistake twice.
The Problem That's Costing You Hours Every Week
Every AI coding agent — Copilot, Cursor, Claude Code, Cline, Aider — has the same fatal flaw:
Monday: Agent learns your entire auth architecture → Session ends → GONE
Tuesday: Same agent. Same project. Knows absolutely nothing.
Tuesday: You re-explain everything. Again.
Wednesday: Repeat. Forever.
That's not pair programming. That's babysitting an amnesiac.
The average developer wastes 45 minutes per session re-explaining context to AI agents.
Over a year, that's 180+ hours — gone.
BrainSync ends the loop in 30 seconds.
Install BrainSync → Code normally → Extension captures observations silently
→ Next session, any agent in any IDE picks up exactly where you left off.
Zero config. Zero API keys. Zero cloud. Zero dollars. Just memory that persists.
The Observation Engine™ — Captures What You'd Forget
Most tools store text. BrainSync doesn't store — it observes.
The Observation Engine runs silently and captures intelligence from live sources:
| Source |
What Gets Captured |
| File Saves |
Every diff analyzed — conventions, architecture changes, import patterns |
| Terminal Output |
Errors, stack traces, build commands, deployment patterns |
| Editor Activity |
Hot files, co-change patterns, time-weighted focus areas |
| Diagnostics |
Compiler errors, linter warnings, type mismatches in real-time |
Each observation is classified into 9 semantic categories — not by an LLM (which costs tokens) — but by a proprietary heuristic classifier running at $0:
| Category |
What Triggers It |
Why It Matters |
| 🔴 Gotcha |
"Don't", "avoid", "warning", "never" |
Stops agents from repeating your known mistakes |
| 📐 Convention |
"Always", "standard", "rule", "must" |
Enforces your project's unwritten laws |
| 🤔 Decision |
"Chose", "decided", "went with" |
Records the why behind architectural choices |
| ⚖️ Trade-off |
"Trade-off", "vs", "instead of" |
What you considered and rejected |
| 🟡 Problem Fix |
"Fix", "error", "resolve", "solved" |
Builds a permanent error→fix knowledge base |
| 🔵 How It Works |
"Because", "works by", "architecture" |
Maps system internals your agents need |
| 🟢 What Changed |
File diffs, imports, refactors |
Tracks the living evolution of your codebase |
| 🔮 Discovery |
"Found", "discovered", "TIL" |
Captures insights before they evaporate |
| 🔧 Tool Pattern |
Repeated commands, build sequences |
Learns your workflow muscle memory |
The Intelligence Cortex — 20 Modules That Think, Not Just Store
This is what separates BrainSync from every "memory" tool that's really just a glorified notepad:
| Module |
What It Does |
| 🔄 Co-Change Detection |
"You edited auth.ts, you probably need auth.test.ts too" |
| 🔥 Hot File Tracker |
Highlights your most-edited files so agents know where the action is |
| 🏷️ Auto Tech Stack |
Detects Next.js, Flutter, Django — adapts context automatically |
| 🔁 Error→Fix Pairs |
Same error? Same fix. Instantly. No re-debugging. |
| 🛡️ Gotcha Promotion |
A mistake that happens 3x auto-promotes to ⚠️ critical warning |
| 📝 Skills Compiler |
2+ similar observations → auto-compiled into reusable skills every 10 min |
| 🎯 Custom Skills |
Create skill packs (e.g. "UI Design") with rules, references, and scripts |
| 🚀 Skill-First Workflow |
Agents create convention skills BEFORE executing major tasks |
| 📈 Learning Curve |
🌱 New → 🔍 Exploring → 📈 Productive → 🧠 Expert |
| 💡 Proactive Nudges |
"You usually edit this test file when you change auth" — before you forget |
| 🧹 Auto Compactor |
Forgetting curve — stale observations auto-compressed, gotchas never pruned |
| 🤖 Self-Correction |
Detects when agents ignore memory and reinforces critical observations |
| 🔍 Semantic Search |
Offline vector embeddings — find related observations by meaning, not keywords |
| 🗺️ Viewport Pumper |
Real-time context injection for the exact file you're editing right now |
| ⚡ Rapid Learning |
Accelerated pattern detection for new projects |
| 🧠 Smart Summarizer |
Intelligent observation condensation — natural language, not diffs |
| 🔗 Knowledge Graph |
Entity-Relation model — connects your codebase concepts automatically |
| 🤝 Agent Sync |
Multi-IDE rule file injection — scored, budgeted, prioritized |
| 🎯 AI Enhancer |
Free AI-enhanced reasoning |
| 📊 Structural Analyzer |
Safe extraction of structural code context |
Universal Agent Sync — One Memory, Every IDE
BrainSync generates agent-native context files that each AI agent reads on startup — zero configuration:
| Agent |
How BrainSync Syncs |
| Gemini Code Assist |
Auto-generates native agent context |
| Claude Code |
Auto-generates native agent context |
| Cursor |
Auto-generates native agent context |
| Windsurf |
Auto-generates native agent context |
| Cline |
Auto-generates native agent context |
| Aider |
Auto-generates native agent context |
Deep Integration — Any Agent, Instant Memory Access
BrainSync exposes an extensive suite of capabilities through the Model Context Protocol (MCP), including cross-project global memory, semantic code search, automated gotcha retrieval, custom skill creation, structural codebase analysis, free AI reasoning, and external documentation resolution.
Plus free AI capabilities — Offload reasoning safely with $0/query local or cloud processing.
An observation saved in Cursor is available in Claude Code 200ms later. No cloud. No webhooks. Just local file watchers.
🎯 Custom Skills — Teach Your Agents Once, They Remember Forever
BrainSync's Skill System has two modes:
Auto-Skills (fully automatic)
You code → BrainSync captures observations → 2+ similar patterns detected
→ Skill auto-compiled → Agents get rules injected automatically
Custom Skills (agent or user created)
Create professional skill packs with rules, references, and automation scripts:
.agent/skills/custom/ui-design/
├── SKILL.md ← Rules + triggers (auto-routed by file type)
├── references/ ← Deep docs loaded on-demand
│ └── guidelines.md
└── scripts/ ← Automation scripts
Example: Tell an agent "redesign the website" → it creates a ui-design skill first with conventions ("use glassmorphism", "Inter font", "dark mode first") → then executes guided by those rules → next agent who touches CSS files automatically gets the same rules.
Skill-First Workflow
BrainSync prompts agents to plan before executing:
- FIRST create a custom skill with conventions to follow
- THEN execute the task guided by the skill
- The skill auto-routes to all future agents on matching files
No more agents reinventing conventions. Define once, enforce everywhere.
Memory Vaults — Complete Project Isolation
Every project gets its own SQLite database. No cross-contamination. No shared state. No surprises.
~/.brainsync/
├── mydukan/
│ ├── memory ← Project-specific intelligence
│ ├── vectors ← Local semantic embeddings
│ └── skills/ ← Auto-compiled coding skills
├── brandforge/
│ ├── memory
│ ├── vectors
│ └── skills/
└── solar-app/
├── memory
├── vectors
└── skills/
Project identity auto-detected from git remote URL or workspace folder name. Zero configuration.
Privacy — Local by Design, Not by Afterthought
We don't do cloud sync. By design.
| Layer |
Protection |
| Storage |
100% local at ~/.brainsync/{project}/ — never touches a server |
| Network |
Zero outbound HTTP. Zero telemetry. Zero analytics. Verify with Wireshark. |
| Secrets |
Auto-filters API keys, passwords, tokens, private keys, .env contents |
| Custom |
Your own regex privacy patterns for domain-specific filtering |
| Control |
One-click memory clear. Full JSON export. You own your data. |
| Safety |
🛡️ SafetyGuard™ — 30+ dangerous command patterns blocked in real-time |
Your code, your observations, your machine. Nothing leaves. Nothing phones home. Ever.
How BrainSync Compares
|
Claude-Mem |
ContextVault |
BrainSync |
| Install |
CLI plugin |
MCP setup |
VS Code → 1 click |
| Works in |
Claude Code only |
MCP agents |
6+ agents auto-synced |
| Server |
Express.js on port |
MCP server |
None. Zero. In-process. |
| External API |
Anthropic ($) |
None |
$0 by default |
| Intelligence |
Static storage |
Static storage |
20 self-learning modules |
| Knowledge Graph |
None |
None |
✅ Entity-Relation |
| Semantic Search |
None |
None |
✅ Local embeddings |
| Custom Skills |
None |
None |
✅ Auto + Custom skills |
| Error→Fix Pairs |
None |
None |
✅ Auto-pairs |
| Safety Rules |
None |
None |
✅ SafetyGuard™ (hard + soft) |
| Interactive Sidebar |
None |
None |
✅ 13 features |
| License |
AGPL-3.0 |
MIT |
Proprietary (Free) |
Install — 30 Seconds, Then Forget About It
- Open VS Code, Cursor, Windsurf, or Antigravity
Ctrl+Shift+X → Search "BrainSync"
- Click Install
That's it. No API key. No config file. No setup wizard.
BrainSync activates on workspace open and starts observing silently. You'll forget it's even there — until you notice your agents suddenly remember everything.
💡 Pro tip: Enable auto-update (Settings → Extensions → Auto Update) so you never miss a fix.
Commands
All optional. BrainSync works automatically. These are for when you want manual control:
Command (Ctrl+Shift+P) |
What It Does |
BrainSync: Search Memory |
Full-text + semantic search across all observations |
BrainSync: Scan Project |
Deep first-run codebase analysis |
BrainSync: Remember This |
Manual observation from active file |
BrainSync: Regenerate Context Files |
Force-regenerate all agent context files |
BrainSync: Show Memory Stats |
Dashboard: observations, categories, learning curve |
BrainSync: Export Memory (JSON) |
Export everything — your data, your format |
BrainSync: Clear Project Memory |
Nuclear option — wipes all observations for current project |
Settings
Every setting is optional. Sane defaults. Zero config required.
| Setting |
Default |
Description |
brainsync.enabled |
true |
Master kill switch |
brainsync.rootContext |
true |
Generate context rules in project root |
brainsync.claudeMdCompat |
true |
Enable Claude Code advanced formats |
brainsync.captureTerminal |
true |
Capture terminal output as observations |
brainsync.captureFileChanges |
true |
Analyze file diffs on save |
brainsync.maxObservations |
50 |
Max observations injected into context files |
brainsync.privacyPatterns |
[regex...] |
Custom regex patterns to exclude from capture |
Built By
Dawood Ahmad — building developer tools that respect your privacy and your wallet.
License
Proprietary © 2025-2026 Dawood Ahmad
Free to use. See LICENSE.txt for full terms.