OCD — Omni Coder Dashboard v5.6.0

The open-source AI memory engine for coding tools

A self-building brain across all your AI coding tools. Real semantic embeddings out of the box, 25 MCP tools, cross-tool routing, prompt science, proactive IDE interception, session guard, trace auditing, and a Memory dashboard — all 100% local, zero API keys required.

<p align="center"> <img src="docs/screenshots/command-center.png" alt="OCD Dashboard — Command Center showing cross-tool AI productivity metrics" width="100%"> </p>

---

What's New in v5.6.0

Session Guard, Guard Effectiveness KPIs, Context Stitching, and 8 security patches.

• OCD Session Guard — Pre-tool guard with session overrun detection (hard stop at 100 turns / 300 min), repetition detection (warn at 3, block at 5), edit-without-read and SQL-without-schema warnings. Post-tool logger with fingerprinting and auto-pruning. Protects against runaway sessions and hallucination loops.
• Guard Effectiveness KPI Matrix — Tracks every guard intervention (block/warn/override) with estimated token savings. New get_guard_effectiveness MCP tool returns a formatted KPI report with daily bar chart and quality impact delta.
• Context Stitching — Single-call session bootstrap via get_context_stitch MCP tool, replacing 5 separate MCP calls. Returns last session context, handoff notes, production errors, anti-pattern constraints, and a DIRECTIVE (CONTINUE / REDIRECT / NEW_SESSION) with suggested prompt for cross-LLM session intelligence.
• Cross-IDE Session Guard — New get_session_guard_verdict and report_tool_call MCP tools expose the session guard to any IDE, not just Claude Code.
• Dashboard Fixes — Data freshness (watcher rebuilds stats after ingestion), LLM detection (.env loaded correctly), entity extraction accuracy, negative constraint precision, and Windows auto-start scripts.
• Security — Patched 8 vulnerabilities: Vite arbitrary file read + path traversal (HIGH), 5 Hono cookie/IP/path issues (MODERATE), @hono/node-server middleware bypass (MODERATE).

<details> <summary><strong>v5.5.0 additions</strong> (click to expand)</summary>

• Trace-to-Evidence Audit Bot — New audit engine that accepts a question (e.g. "is our mapping seed data correct?") and orchestrates parallel evidence gathering from code grep, session memory, anti-patterns, and config files. Produces structured reports with verified/broken/missing verdicts. 3 built-in templates (Mapping Validation, Ingestion Throttle, Fallback Behavior) plus ad-hoc question support. Exposed via MCP tools run_trace_audit, get_audit_history, and list_audit_templates.
• Antigravity Session Intelligence — Deep session analysis for Gemini/Antigravity sessions: resolved artifact versioning, intent classification (plan/implement/verify/rollback/investigate), line-level version deltas, file impact analysis (by extension and module), and protobuf conversation reconstruction with gzip/inflate decompression.
• Antigravity Intelligence UI — New Workspaces panel showing version delta summaries, intent distribution bars (color-coded), and file impact breakdowns for Antigravity sessions.
• Cost Visibility — Model normalizer that maps vendor-specific model names to canonical families, cost alerting thresholds, and accurate Cursor token estimation from actual conversation data.
• Windows Launcher — ocd-start.bat double-click script that builds server + client, kills stale processes, starts the dashboard, verifies MCP configuration, and opens the browser.

</details> <details> <summary><strong>v5.4.0 additions</strong> (click to expand)</summary>

• Real Local Embeddings — Ships all-MiniLM-L6-v2 via ONNX runtime (@xenova/transformers). Every session gets 384-dimensional semantic vectors automatically. The hash-based fallback is now a last resort, not the default. Your "semantic memory" is actually semantic now.
• Memory Dashboard — New "Memory" tab in Insights showing: active embedding provider, coverage %, provider breakdown, quality labels (semantic vs keyword), and a live similarity search box to test your memory bank.
• Shell Hook Installer — pnpm install-hook (or ocd install-hook) appends a PROMPT_COMMAND/precmd hook to your .bashrc/.zshrc that automatically captures terminal errors for proactive IDE interception. No manual log file setup.
• Match Quality Labels — MCP search results now say "(semantic match)" or "(keyword match)" so you know whether you're getting real vector similarity or just keyword overlap.
• P2P Security Transparency — Dashboard shows a warning banner when P2P sync is active over plaintext HTTP, with guidance to use VPN/Tailscale for sensitive environments.
• No More 1000-Row Cap — Similarity search now scans all embeddings, not an arbitrary subset.

</details> <details> <summary><strong>v5.2.x additions</strong> (click to expand)</summary>

• Platform Parity — All adapters (Windsurf, Continue.dev, Copilot, Aider) now match Claude Code's parsing depth: turn-level analysis, code metrics, tool detection, and error tracking across every platform.
• Single-Tool User Optimization — The routing engine detects single-tool users and provides model-level recommendations instead of irrelevant cross-tool comparisons.
• Session Health Check — get_session_health_check MCP tool gives agents cross-session self-awareness with structured continue/compact/new_session action signals.
• Token Efficiency Tips — Personalized get_efficiency_tips MCP tool: burn rate, waste detection, quick wins from your very first session.
• Prompt Science — Evidence-based prompt engineering with effect sizes and sample counts mined from your best sessions.
• Architecture Hardening — Structured logging (pino), Swagger/OpenAPI docs, route modularization, DB index tuning.

</details> <details> <summary><strong>v5.1 additions</strong></summary>

• Proactive IDE Interception — Background watcher monitors your terminal for stack traces, finds matching solutions via vector search, and fires OS-level notifications + SSE pushes to your IDE instantly — no prompt needed.
• Anti-Hallucination Negative Prompt Injector — Builds an Anti-Pattern Graph from your failing sessions and injects explicit DO NOT use X constraints into new prompts via the get_negative_constraints MCP tool.
• Token Arbitrage & Cost Routing — Classifies every prompt by task type and complexity, routes to local Ollama (free) when your historical success rate is ≥ 92%, and logs estimated savings per request.
• P2P Secure Team Memory — Syncs embeddings across teammates on the same LAN or Tailscale using UDP discovery + HMAC-SHA256 authentication. No cloud, no source code shared — embeddings only.

</details>

---

Usage by Experience Level

Whether you just installed your first AI coding tool or you're orchestrating multi-agent pipelines, OCD meets you where you are.

Beginner — "I just started using AI coding tools"

npx omni-coder-dashboard                    # 1. Launch — zero config, auto-detects your tools

• What you get on day one: A visual dashboard showing every session across all your AI tools, how many tokens you used, and which sessions succeeded vs. failed. Semantic memory starts building immediately — every quality session is embedded with a local neural model (no API keys needed).
• Start here: Open the Command Center tab — it shows your daily activity, top tools, and a savings estimate. Check Insights → Memory to see your embedding coverage grow.
• Key MCP tools to try:
  • get_efficiency_tips — personalized tips to reduce token waste, even with one session of data
  • get_routing_recommendation — asks "which tool + model should I use for this task?" and answers with your own data
  • get_similar_solutions — finds past solutions matching your current error (works after ~5 sessions)
• Tip: Just use your AI tools normally. OCD watches in the background and builds your personal knowledge base automatically. Run ocd install-hook to also capture terminal errors for proactive matching.

Intermediate — "I use multiple AI tools and want to optimize"

npx omni-coder-dashboard --setup-mcp        # Auto-configure MCP for Claude Code, Cursor, Windsurf

• Unlock cross-tool intelligence: OCD tracks sessions across all 7 supported tools. The Performance tab lets you compare win rates, token costs, and resolution speed per tool and model.
• Semantic memory is already working: Real 384-dim embeddings are generated automatically from day one. After ~20 quality sessions, get_similar_solutions starts returning strong matches. Solutions from Claude Code surface in Cursor, and vice versa. Check Insights → Memory to see your coverage and test live searches.
• Key MCP tools to add:
  • get_similar_solutions — vector search across all your past sessions
  • get_optimal_prompt_structure — evidence-based prompt patterns mined from your best sessions, with effect sizes
  • get_session_health_check — periodic health signals so your agent knows when to compact or start fresh
  • get_negative_constraints — auto-injects "DO NOT" clauses from your failure history
• Tip: Check the Insights → Prompt Science tab weekly. It surfaces which prompt structures, lengths, and patterns correlate with higher quality in your sessions.

Advanced — "I want full agent orchestration and team workflows"

# Semantic embeddings work out of the box — no config needed
npx omni-coder-dashboard

# Upgrade to Ollama for 768-dim embeddings + LLM features
OLLAMA_HOST=http://localhost:11434 npx omni-coder-dashboard

# Auto-install shell hook for proactive IDE interception
ocd install-hook

# Enable P2P team memory (LAN or Tailscale)
P2P_SECRET=your-team-key npx omni-coder-dashboard

# Docker for always-on deployment
docker compose up -d

• Agent-grade MCP integration: All 25 MCP tools are designed for autonomous agent consumption — structured JSON responses, confidence scores, and action signals (continue/compact/new_session).
• Token arbitrage: Route prompts to local Ollama when your historical success rate is high enough, saving API costs automatically. Full audit trail via get_arbitrage_recommendation.
• P2P team memory: Share embeddings (never source code) across your team with HMAC-SHA256 authentication. Query teammate solutions with get_team_memory. Dashboard shows security warnings when running over plaintext HTTP.
• Proactive IDE interception: Run ocd install-hook to auto-configure your shell. Errors are captured to ~/.ocd/terminal.log and matched against your vector store in real time. Solutions are pushed via OS notifications + SSE before you open a new prompt.
• Production deployment:
  • Swagger/OpenAPI docs at /docs for REST API integration
  • Structured JSON logging (pino) for log aggregation pipelines
  • AUTH_TOKEN env var for shared/CI environments
  • Webhook + API endpoints for CI/CD session ingestion
• Key MCP tools for agents:
  • get_session_health_check — cross-session self-awareness for long-running agents
  • get_knowledge_context — graph neighborhood traversal for deep context i