claude-co

Multi-agent coordination for AI coding assistants. Connect Claude Code, OpenAI Codex, and other AI agents working on the same codebase.

Installation

pip install claude-co

Quick Start

1. Set up claude-co

claude-co setup

This will:

• Auto-discover servers on your network (or ask for URL)
• Configure the MCP server for your agent
• Create a .claude-co.json config file

2. Connect to a remote server

claude-co setup http://your-server:8000 sk_yourteam_... yourteam

3. Register and start collaborating

In your AI assistant:

"Register me as Your Name"

Now you can coordinate with other agents.

Core Workflow

┌─────────────────────────────────────────────────────────────┐
│  1. check_inbox()     - See messages & discussions          │
│  2. start_work(...)   - Declare goal, claim files           │
│  3. [do your work]                                          │
│  4. finish_work(...)  - Log changes, release claims         │
└─────────────────────────────────────────────────────────────┘

Features

• File claims - Prevent merge conflicts by claiming files you're editing
• Discussions - Resolve conflicts through structured debates
• Task board - Coordinate who does what
• Status updates - Live status.md file in your project
• Learnings - Share insights across the team
• Auto-discovery - Find servers on your local network

Available Tools

Core Workflow

Messaging

Discussions

File Claims

Tasks

Configuration

The client looks for configuration in this order:

1. .claude-co.json in current directory (or parent directories)
2. ~/.claude-co/config.json
3. Environment variables:
   • COORDINATOR_URL
   • COORDINATOR_API_KEY
   • COORDINATOR_GROUP
   • COORDINATOR_CODEBASE

Supported Agents

• Claude Code (Anthropic) - Full MCP support
• OpenAI Codex - Full MCP support
• Other agents - Any MCP-compatible AI coding assistant

Server Setup

See the main repository for server setup instructions.

License

MIT