Claud**IO

Claudio lets Claude Code sessions message each other.

curl -fsSL https://raw.githubusercontent.com/mekarpeles/cmux/main/install.sh | bash

How it works

Claudio wraps around Claude Code sessions and adds the ability to discover other running agents, pair with them, and send them messages.

alice

bob

Orchestrate `claudio` teams using `cmux`

cmux is a multiplexer that enables you to easily run multiple concurrent, communicating claudio agents using tmux. It has a CLI that feels like tmux meets docker. You can manage Claude sessions in tmux windows, spin up new agents, and have agents message each other directly in real time.

# start a named agent
cmux up alice -d

# send it a message
cmux send alice "please review PR #42"

Per-agent TODOs with `cq`

# create an issue for the current agent
cq issue create -t "review PR #42"
cq issue list
cq issue close 1

cq is a lightweight task queue designed for claudio agents. It is based on gh and implements GitHub's Issues API locally as .cq/ on disk. cq works without claudio but claudio and cmux offer utilities to make these tools work seamlessly together.

Commands

claudio discover

List running agents

Scans the state directory and shows all live agents with their names and socket paths.

claudio pair <socket>

Pair with an agent

Exchange socket addresses in a direct handshake. No registry required.

claudio send <name> <msg>

Send a message

Delivers to any paired agent by name, or to any socket path directly.