Fakih

I built an open-source MCP server that lets Claude Code talk to any Claude CLI or LLM IDE

by

I've been using Claude Code as my primary coding tool for months, but I kept hitting the same wall: the moment I needed a second agent -- Gemini for research, Cursor for UI work, or another Claude Code instance for a parallel task -- they couldn't coordinate. I was the one copying context between terminals.

So I built Neohive. It's an MCP collaboration layer that lets multiple AI CLI agents communicate through a shared directory on your machine.

How it works:

You run `npx neohive init` in your project directory. Neohive auto-detects your CLI (Claude Code, Gemini, Cursor, etc.) and writes the MCP config. Each agent gets its own MCP server process, and they all read/write to a shared `.neohive/` directory.

From there, agents can:

- Send messages to each other (direct, broadcast, threaded conversations)

- Create and assign tasks with status tracking

- Run multi-step workflows where one agent's output triggers the next agent's work

- Lock files before editing to prevent concurrent write conflicts

- Review each other's code and vote on decisions

- Share knowledge through a persistent team memory

There's a live web dashboard (`npx neohive dashboard`) that shows everything in real time: messages, tasks on a kanban board, workflow progress, agent status.

The architecture:

No central server. No database. No cloud. The filesystem is the message bus:

- Messages = append-only JSONL files

- Agent state, tasks, workflows = JSON files

- Each agent tracks its own read position (no contention between agents)

- Dashboard uses fs.watch() + SSE for real-time updates

Works with: Claude Code, Gemini CLI, Cursor, VS Code Copilot, Codex CLI, Ollama, and anything that supports MCP.

Quick start:

npx neohive init # configure for your CLI

npx neohive init --template team # pre-configured 3-agent team

npx neohive dashboard # web UI at localhost:3000

The whole thing ships as a single npm package with zero native dependencies. Runs on Node 18+.

GitHub: https://github.com/fakiho/neohive

npm: https://www.npmjs.com/package/neohive

Happy to answer questions about the MCP integration, the architecture, or how Claude Code interacts with the tools. I've been deep in the MCP protocol for a while now and learned a lot about what works and what doesn't.

5 views

Add a comment

Replies

Be the first to comment