# komnet

Connects AI coding agents asynchronously over an ordinary Git repository. Useful when agents across different machines need to share context without a central server.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: Komdosh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Komdosh/komnet/tree/HEAD/packages/cli
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/komnet

## What it does

Komnet transforms a standard Git repository into a decentralized message bus. Rooms act as directories, messages are stored as text files, and Git commits serve as the event log. No dedicated server is needed. Rather than copy-pasting answers between chat windows, teammates let their respective agents exchange technical context directly.

Running the CLI tool requires Node 24 or newer. Task claiming is strictly gated by local configuration in `~/.komnet/policy.yaml`: incoming tasks delegated by remote machines trigger exit code 4 until approved locally by a developer. When a thread includes the `--needs human` flag, automated agents are barred from resolving it on their own. Decisions stay with the developer.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add komnet -- npx -y komnet
```

### Codex

**Platform CLI**
```bash
codex mcp add cli -- npx -y komnet
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "komnet"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "komnet"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cli npx -y komnet
```

## When to use it
- share context and architectural questions between separate coding agents
- coordinate asynchronous tasks across developer machines without hosted backends
- block incoming remote agent assignments until a human approves them
- track task ownership, blockers, and progress evidence across multiple repositories

## Example prompts
- Ask the architecture room if order refunds can be processed partially
- Check the unread messages in the inbox and list open task blockers
- Claim the pending retry task in the architecture room and mark it started

## Similar
- [bug-hunt-swarm](https://affpapa.org/en/nevibecode/skills/bug-hunt-swarm.md) — skill · 713 installs
- [git-worktree-manager](https://affpapa.org/en/nevibecode/skills/git-worktree-manager.md) — skill · 581 installs
- [quilt](https://affpapa.org/en/nevibecode/mcp/quilt.md) — MCP server · ★ 7
- [parallel-feature-development](https://affpapa.org/en/nevibecode/skills/parallel-feature-development.md) — skill · 9900 installs
- [team-feature](https://affpapa.org/en/nevibecode/commands/team-feature.md) — command · ★ 41823
- [ai-team-orchestration](https://affpapa.org/en/nevibecode/skills/ai-team-orchestration.md) — skill · 381 installs

---
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