# continuum

A local MCP orchestrator that gives coding agents shared vector memory in SQLite. It coordinates tasks across git worktrees to keep parallel sessions from clashing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 92
- Author: pouyahasanamreji
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pouyahasanamreji/continuum
- Updated: 2026-05-14
- HTML: https://affpapa.org/en/nevibecode/mcp/continuum

## What it does

Continuum turns an MCP client into an orchestrator for your project. It seeds a workflow from `PLOT.md` through four phases: intake, research, verification, and handoff. Agents record project findings into SQLite with `sqlite-vec`, sorting rules into core constraints and situational notes. Future sessions retrieve those lessons through semantic search instead of asking you to repeat project rules.

The architecture runs on NestJS. It includes an Astro dashboard for inspection. By default, it builds 768-dimension vectors inside the process with Transformers.js. You do not need external API keys. If you want custom embeddings, set `EMBEDDER_URL` to target Ollama or a TEI instance.

Parallel work stays safe because the registry tracks file collisions using `reserved_paths`. If an active agent already claims a directory, the next task will not overwrite it. To run the system locally, you need Docker or Node `>=22.12.0` with pnpm `10.33+`.

## Requirements
- Needs: Docker
- Environment variables: `ORCHESTRATOR_DB_PATH`, `EMBEDDER_URL`, `EMBEDDER_MODEL`, `EMBEDDER_DIM` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- share project context across separate Claude Code and Codex chats
- stop concurrent agents from modifying the same files in git
- store debugging insights in a local `sqlite-vec` vector database
- dispatch new tasks into isolated worktrees using `PLOT.md`

## Example prompts
- Read the project plot and generate a prompt for a fresh agent in a clean worktree.
- Search stored project lessons about retry handlers using `knowledge_search`.
- Check active agent statuses and locked directories via `registry_list`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md