swarmux

swarmux is a command-line task runner for developers coordinating coding agents in tmux. Each task gets its own session and git worktree, so you can supervise separate jobs while keeping access to their terminals.

• Separate coding tasks: Run tasks in dedicated sessions and worktrees through the coding assistant or command you choose, without committing to one agent.
• Human supervision: Inspect and steer running work directly, with task-aware terminal interfaces for viewing tasks and switching between panes.
• Automation output: Submit, start and track tasks through commands that validate inputs and return JSON by default, with text output available for human readers.
• Execution modes: Run jobs headlessly, keep command-line runners visible with output copied into logs, or use full-screen interactive programs in dedicated sessions.
• Monitoring and cleanup: Follow task state and log previews, receive tmux notifications, reconcile task state and prune managed sessions and worktrees after tasks finish.

swarmux extends an existing tmux workflow. It requires tmux, git and a POSIX shell, and provides tmux bindings through TPM. Task state stays local in files by default, with an optional beads backend. The orchestration runs locally; cloud use depends on the coding agent or command it launches. swarmux is open source under the MIT license.