tmux-first local control plane

swarmux

Agent-native Rust CLI for tmux-based orchestration of local coding tasks. Tasks run in local tmux sessions with deterministic task state and direct human access and inspectability.

tmux visibility pane tree task states files/beads backends reconcile + prune
swarmux local operator view 
$ swarmux doctor
$ swarmux init
$ tmux source-file ~/.config/tmux/tmux.conf
$ ~/.tmux/plugins/tpm/bin/install_plugins
$ swarmux dispatch --connected --human --prompt "fix tests"
$ swarmux panes jump --index 1
$ swarmux overview --tui
swarmux overview tasks screenshot

Why swarmux

  • swarmux extends tmux instead of introducing a separate orchestration runtime.
  • TPM plugin bindings are the canonical tmux integration path.
  • Run each task in its own tmux session and git worktree, with direct operator visibility.
  • Keep agent automation scriptable via JSON output by default.
  • Add task-aware TUIs and agent-agnostic task management around the existing tmux workflow.
  • Prune managed worktrees and sessions after terminal states.

Next step

Read Get Started for setup, tmux mapping, and first task flow.