explaingit

xuanlinai/overmind

Analysis updated 2026-06-24

43JavaScriptAudience · developerComplexity · 4/5Setup · moderate

TLDR

External cognitive engine for Claude Code with 66 modules across 6 channels, layered SQLite/graph memory and 20 MCP tools wired in via one installer.

Mindmap

mindmap
  root((overmind))
    Inputs
      Claude Code session
      DeepSeek API key
      Repo state
    Outputs
      Compressed context
      Fleet broadcasts
      Knowledge graph
    Use Cases
      Persistent agent brain
      Cross session memory
      Multi session fleet sync
    Tech Stack
      Node
      Python
      SQLite FTS5
      MCP
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give Claude Code a persistent shared brain across sessions

USE CASE 2

Run a fleet daemon that scans all open Claude Code sessions every 5 seconds

USE CASE 3

Use SQLite FTS5 plus jieba tokenizer for bilingual agent memory search

USE CASE 4

Wire 20 MCP tools for memory save, graph expansion and skill management

What is it built with?

NodePythonSQLiteMCPDeepSeek

How does it compare?

xuanlinai/overmindvzzoxo/xiaoyizishootthesound/comfyui-angelo
Stars434239
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderatemoderate
Complexity4/54/53/5
Audiencedeveloperops devopsdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

One-command installer but requires a DEEPSEEK_API_KEY plus Python and Node deps, and rewires Claude Code's hook and MCP config.

In plain English

overmind is a bilingual Chinese-and-English project that bills itself as Xuanlin Overmind v4, also called the Immeasurable Network Refactored. The README describes it as an external cognitive engine for Claude Code: 66 modules wired together through 6 channels and an event bus, intended to give every Claude Code session a shared, persistent brain that keeps thinking even when the user is away. The author frames it less as a plugin and more as a nervous system that sits behind the coding agent. Install is one command: git clone the repo and run node install.js. That installer runs six steps: it probes the host environment (OS, CPU, memory, disk, Python, Node, and which AI agent is present), takes a safety snapshot of key files, checks integrity and auto-repairs missing pieces, installs npm and pip dependencies on demand, generates the .overmind_env.json plus hook and MCP wiring into Claude Code, and runs a smoke test across all six channels with automatic rollback on failure. After install the user sets a DEEPSEEK_API_KEY and restarts Claude Code. The six-channel architecture splits work across CH1 (a 37-stage serial pipeline for intent prediction, safety gates, red-team review, output shielding, and other checks), CH2 (48 parallel broadcast modules), CH3 and CH4 (the z2 hub, where a daemon.py FleetWatcher scans all CC sessions every 5 seconds and broadcasts to peers through .fleet_broadcast.md and an event queue), and CH5 and CH6 (the n2 terminal, where a communicator filters incoming context through a flash model at a claimed 94 percent compression and then post-processes through 8 serial and 11 parallel modules). Memory is layered five ways: semantic memory in SQLite with FTS5 and the jieba Chinese tokenizer, procedural memory that promotes a pattern to a reusable template after three uses, episodic session summaries, a knowledge graph of 4500-plus nodes connected by ten relation types like depends_on and blocked_by, and a feedback loop that scores effectiveness from 4500-plus events. Twenty MCP tools expose search, save, graph expansion, fleet status, and skill management. The README claims a 0.001 ms p50 core latency, 270 pipeline stages per second, under 500 MB memory for all 66 modules, daily API cost of 5 to 15 US cents, and a 42-of-42 release self-test. A competitive table at the end compares it to Mem0 and AgentMemory and pitches Overmind as the brain rather than the hard drive of an AI agent.

Copy-paste prompts

Prompt 1
Clone overmind, run node install.js and walk me through what each of the six install steps did to my Claude Code config.
Prompt 2
Show me where the .overmind_env.json hook and MCP wiring gets injected and how to roll it back.
Prompt 3
Explain the CH3/CH4 z2 FleetWatcher daemon in overmind and how peers receive broadcasts.
Prompt 4
Tune the flash-model compression in CH5/CH6 of overmind to keep below 100 input tokens per turn.
Prompt 5
Adapt overmind's procedural-memory promotion rule (three uses then template) for my own agent project.

Frequently asked questions

What is overmind?

External cognitive engine for Claude Code with 66 modules across 6 channels, layered SQLite/graph memory and 20 MCP tools wired in via one installer.

What language is overmind written in?

Mainly JavaScript. The stack also includes Node, Python, SQLite.

How hard is overmind to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is overmind for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.