# 1. Install
npm install -g local-brain-mcp

# 2. Init — auto-detects Claude Code, Cursor, Copilot, Windsurf
npx local-brain init

# 3. Ingest your git history
cd /path/to/your-project
npx local-brain ingest

# 4. Restart your AI editor — the MCP tools are now available

{
  "query": "JWT auth bug",
  "file_path": "src/auth/jwt.ts",
  "max_items": 5,
  "category": "fix"
}

## Brain Recall: "JWT auth bug"
• [src/auth/jwt.ts @ 8a4f12] (fix): JWT refresh race condition — RS256 cert rotates every 24h. Never use HS256 in dev.
• [src/auth/session.ts @ c31d04] (bug): Sessions expire silently on Tuesdays 02:00 UTC — auth service maintenance window.

{
  "lesson": "Always seed the test DB before running Playwright tests or auth flows break.",
  "category": "convention",
  "file_path": "tests/setup.ts"
}

{
  "file_path": "src/db/client.ts"
}

{
  "status": "stale",
  "run_invalidation": true
}

local-brain init              # setup wizard — writes MCP config for all detected editors
local-brain ingest            # scan git history and build the brain DB
local-brain ingest --since "6 months ago" --verbose
local-brain status            # show DB memory counts
local-brain prune --invalidate  # detect + remove stale memories

git history
    ↓
[git-ingest.ts] — filters WIP/typo/format commits
    ↓
[embeddings.ts] — pure-JS TF-IDF feature hashing (sub-1ms, zero network)
    ↓
[db.ts] — stores in .git/brain.db (Float32Array BLOB vectors in SQLite)
    ↓ (on file change)
[invalidation.ts] — marks stale if file changed > 30%
    ↓ (on MCP tool call)
[recall.ts] — in-memory cosine similarity search, scoped to package, capped to 250 tokens
    ↓
Claude Code / Cursor / Copilot / Windsurf / Zed