claude-tmux


MCP server for orchestrating multiple Claude Code instances via tmux.

Installation

Add to your Claude Code MCP settings:

``json
{
"mcpServers": {
"claude-tmux": {
"command": "npx",
"args": ["-y", "claude-tmux"]
}
}
}
`

$3

- tmux must be installed
- Claude Code CLI must be installed

Tools

$3

Launch a new Claude Code instance in a tmux session.

`
spawn(name, prompt, workdir)
`

- name: Unique session name (e.g., 'refactor-auth', 'debug-api')
- prompt: Initial prompt to send to Claude
- workdir: Working directory for Claude to operate in

$3

Wait for a Claude session to finish working and return the terminal output.

`
read("task-name")
`

$3

Send a follow-up message to a running Claude session.

`
send("task-name", "do something else")
`

$3

List all active Claude tmux sessions.

`
list()
`

$3

Terminate a Claude tmux session and clean up resources.

`
kill("task-name")
`

Usage Pattern

`
spawn(name, prompt, workdir) → start session
read(name) → wait for completion, get output
send(name, text) → steer with follow-up
read(name) → wait for completion, get output
kill(name) → cleanup
`

Tips

- Verify output shows task completion before killing. Idle agents are fine to leave running.
- Attach manually: tmux attach -t claude-`