PLUGINS & ORCHESTRATION

conductor-mcp

MCP server for orchestrating Claude Code workers via tmux. 35 tools for spawning, monitoring, coordinating, and controlling AI worker sessions.

"No Chrome required. Brings TabzChrome's orchestration superpowers to any terminal."

MCP Tools

Stars

321 KB

Size

Jan 2026

Created

Project Overview

Conductor MCP is a Model Context Protocol server that turns tmux into an orchestration layer for Claude Code workers. It exposes 35 tools that let a "conductor" AI spawn, monitor, and coordinate multiple AI workers -- each running in its own tmux pane with its own git worktree.

The key insight: tmux is already the perfect process manager. Rather than building custom infrastructure, Conductor wraps tmux's primitives (sessions, windows, panes) with MCP-compatible tools, adds TTS for voice status updates, and provides signal-based coordination channels between workers.

Tech Stack

Python 41% Shell 31% HTML 28%

Python + MCP SDK

Model Context Protocol server implementation

tmux

Session, window, and pane management backend

edge-tts

Text-to-speech for voice status updates

Git Worktrees

Isolated branches per worker

Beads Integration

Issue tracking per spawned worker

Signal Channels

Inter-worker coordination protocol

Architecture

[C]

Conductor

Orchestrating AI that plans tasks and delegates to workers

[M]

MCP Server

35 tools exposed via Model Context Protocol

[T]

tmux Backend

Sessions, panes, and pipe-pane streaming

spawn_worker → creates worktree + tmux pane + beads issue
send_keys → types commands into worker panes
watch_pane → streams pane output via pipe-pane
send_signal / wait_for_signal → channel-based coordination
speak → TTS announcements via edge-tts

35 MCP Tools

Core 5 tools

fn send_keys

fn spawn_worker

fn speak

fn kill_worker

fn list_workers

Sessions 2 tools

fn create_session

fn create_window

Panes 6 tools

fn split_pane

fn create_grid

fn list_panes

fn focus_pane

fn kill_pane

fn spawn_worker_in_pane

Monitoring 3 tools

fn watch_pane

fn stop_watch

fn read_watch

Sync 2 tools

fn wait_for_signal

fn send_signal

Popups 2 tools

fn show_popup

fn show_status_popup

Hooks 3 tools

fn set_pane_hook

fn clear_hook

fn list_hooks

Layout 4 tools

fn resize_pane

fn zoom_pane

fn apply_layout

fn rebalance_panes

Config 4 tools

fn get_config

fn set_config

fn list_voices

fn test_voice

Stats

MCP Tools

GitHub Stars

321 KB

Repository Size

Tool Categories

Lessons Learned

MCP server design -- exposing 35 tools through the Model Context Protocol with clean parameter schemas and error handling
tmux automation from Python -- subprocess calls to tmux for session/window/pane management, pipe-pane streaming, and layout control
TTS integration -- edge-tts for real-time voice announcements, voice selection, and audio playback coordination
Signal-based coordination between AI workers -- channel-based send/wait primitives that enable producer-consumer patterns across tmux panes