Shadow Brain v6.0.0

April 24, 2026 · View on GitHub

Released: 2026-04-24 Codename: Hive Mind

The first open-source AI brain that works with sub-agents. 22 novel features that don't exist in any other tool — open or closed source. Local-first by default.

🔥 The 5 Headliners

#FeatureWhy it's novel
1Sub-Agent Brain Bridge (SABB)No tool syncs brain memory to sub-agents. Shadow Brain is the first. Supports Claude Code Task, Cursor Composer, CrewAI, LangGraph, AutoGen, generic.
2Causal Memory ChainsEvery decision records its cause. Traceable, auditable, Graphviz-rendered DAG.
3Agent Collision DetectiveReal-time overlap detection between competing agent edit intents, with advisory locks.
4Dream EngineBackground reflective idle loop via local Ollama. Revisit, counterfactual, consolidation, contradiction, pattern-discovery.
5Ed25519 Reputation LedgerCryptographically-signed agent decision receipts. Portable reputation JSON + shields.io badges.

🧠 17 More Never-Seen Features

  1. Swarm Debate Protocol (pro/con/arbiter sub-agents)
  2. Pre-Mortem Assistant (surfaces past failures before tasks)
  3. Branch Brains (git-aware memory context)
  4. Attention Heatmap (weighted memory attribution)
  5. Token Economy Engine (cross-agent spend + savings)
  6. Forgetting Curve + Sleep Consolidation (Ebbinghaus)
  7. Formal Verification Bridge (NL → ESLint/Semgrep/LSP)
  8. Confidence Calibration Monitor (Brier scores)
  9. Cost-Aware Sub-Agent Spawner
  10. Air-Gap Mode (offline, localhost-only)
  11. E2E Encryption (ChaCha20-Poly1305)
  12. Hallucination Quarantine (suspect memory isolation)
  13. Voice Mode (transcript + intent)
  14. Brain Garden (aesthetic visualizer)
  15. PR Auto-Review (GitHub comment generator)
  16. Team Brain Sync (WebRTC P2P, no server)
  17. Brain Exchange (curated slice sharing)

⚡ Hive Accelerator

  • SSSP Router — arXiv 2504.17033 (Breaking the Sorting Barrier) for causal chain traversal: O(m log^(2/3) n)
  • TurboQuant — ICLR 2026 Google Research for 6× vector compression on SABB similarity + brain exchange payloads
  • Local-First Default — all AI features route to Ollama by default. Zero API keys needed.

🖥️ Complete Web Control Dashboard

shadow-brain start . → http://localhost:7341/hive

23 tabs covering every feature:

  • Overview (live stats, agents, memories, dreams, savings)
  • Sub-Agent Bridge (sliver generator + quarantine review)
  • Causal Chains (Graphviz tracer)
  • Collisions (active intents + alerts)
  • Dream Engine (manual cycle + insights)
  • Reputation (leaderboard + badge generator)
  • Swarm Debate
  • Pre-Mortem
  • Attention Heatmap
  • Token Economy (charts + suggestions)
  • Forgetting Curve (consolidation)
  • Formal Rules (ESLint + Semgrep export)
  • Calibration Scores
  • Branch Brains
  • Privacy & Safety (air-gap + quarantine)
  • Voice
  • Brain Garden (live canvas)
  • PR Review generator
  • Team Sync (peers)
  • Exchange (packages)
  • Agents — connect/disconnect per agent, attach/detach all
  • Live Graph — animated canvas with real-time signal particles flowing between brain + agents + sub-agents
  • Activity Log — unified stream of all brain events
  • Config — LLM provider, API keys, MCP server

📊 Numbers

v5.2.0v6.0.0
Brain modules2648
CLI commands~7090+
MCP tools~2760+
Test suites1011
Tests passing124148
TypeScript errors00
Build✓✓

🚀 Install / Upgrade

# Global install
npm install -g @theihtisham/agent-shadow-brain

# Or run direct (no install)
npx @theihtisham/agent-shadow-brain@latest attach-all

# Start everything (dashboard + MCP + watcher)
shadow-brain start .

# Complete web dashboard
open http://localhost:7341/hive

📁 New Files

All v6 modules live in src/brain/:

  • subagent-bridge.ts — SABB
  • causal-chains.ts
  • collision-detective.ts
  • dream-engine.ts
  • reputation-ledger.ts
  • swarm-debate.ts
  • pre-mortem.ts
  • branch-brain.ts
  • attention-heatmap.ts
  • token-economy.ts
  • forgetting-curve.ts
  • formal-verification-bridge.ts
  • calibration-monitor.ts
  • cost-aware-spawner.ts
  • air-gap.ts
  • brain-encryption.ts
  • hallucination-quarantine.ts
  • voice-mode.ts
  • brain-garden.ts
  • pr-auto-review.ts
  • team-brain-sync.ts
  • brain-exchange.ts
  • local-llm.ts
  • hive-accelerator.ts

Plus:

  • src/dashboard/v6-dashboard-html.ts — full 23-tab control dashboard
  • tests/brain/hivemind-v6.test.ts — 24 smoke tests
  • docs/launch/hivemind-explainer.html — 1-minute GSAP explainer video
  • docs/launch/hivemind-captions.srt — SRT captions

🔄 Migration from v5.2 → v6.0

Zero breaking changes to existing APIs. All v5.2 behavior preserved.

New features are opt-in via CLI commands + new MCP tools. Existing sessions continue to work.

If you're already running shadow-brain start ., after upgrade just re-run — you'll see the new /hive dashboard route alongside the existing / dashboard.

🔒 Philosophy

Local-first by default. Dream Engine, Swarm Debate, Pre-Mortem, Voice all route to Ollama first. No API keys required. Works offline, in air-gapped environments, in compliance-constrained enterprises. Remote providers (Anthropic, OpenAI, GLM, MiniMax) remain optional upgrades — never requirements.

Free forever. MIT license. Zero subscription tiers. Zero trial expiration. Zero feature gating.

Open source moat. Closed tools can't match local-first because their business model depends on API consumption. This is your unfair advantage.