workmux

workmux is a terminal-based tool designed to facilitate parallel workflows for AI agents by integrating git worktrees and tmux windows. It addresses the challenges of managing multiple development tasks simultaneously, allowing each task to operate in its own isolated environment. By assigning a dedicated git worktree and tmux window to every task, workmux enables developers and AI agents to work side by side without the need for frequent stashing, branch switching, or encountering merge conflicts. This setup provides each task with its own terminal state, editor session, and development server, making context switching as simple as changing tabs in the terminal.

The tool automates many of the pain points associated with manual git worktree management. When a new worktree is created, workmux can copy configuration files, create symlinks for dependencies, and execute setup commands, ensuring a clean and ready-to-use environment without redundant installations. For finishing tasks, the 'workmux merge' command manages the entire lifecycle: it merges the branch, deletes the worktree, closes the tmux window, and removes the local branch with a single command. Additionally, the platform offers a '/merge skill' that enables agents to autonomously commit, rebase, and merge changes, including handling merge conflicts by rebasing onto the base branch and resolving overlapping changes without manual intervention.

workmux also supports running agents in isolated containers or Lima virtual machines, which keeps host keys, credentials, and files separate while agents operate within their scoped worktree. This sandboxing feature enhances security and isolation for sensitive workflows. A tmux popup dashboard is available to monitor the progress of all agents, providing an overview of ongoing tasks directly within the terminal.

The tool is aimed at users who prefer terminal-centric development environments and want to orchestrate multiple AI agents or parallel development tasks efficiently. workmux is delivered as a terminal application and is released under the MIT License.