Wiki / entities / wiki

workmux

A git-worktree manager for parallel (often AI-agent) development that runs on top of your existing terminal multiplexer (tmux, Zellij, Kitty, WezTerm). Its docs call it a "giga opinionated zero-friction workflow tool"; the philosophy is to build on tools you already use and let workmux orchestrate them.

Core pieces, as demoed by sam-natale:

  • workmux add <branch> creates the branch and worktree, then opens a tmux window (or a whole session in mode: session) with the panes you declared (e.g. Neovim, pnpm run dev, an opencode agent).
  • Repo-level .workmux.yaml has files.copy (.env, .env.local) and files.symlink (node_modules) for the untracked files a fresh worktree lacks, plus a sync command that re-applies them to all existing worktrees.
  • workmux sidebar shows per-agent repo, branch and diff; workmux dashboard has Agents/Worktrees tabs with git, mux and agent status.
  • Every action is a CLI command, so it slots into tmux display-menu, popups and fzf scripts (augment-over-replace).

The archive's counterpoint to herdr: most of the agent-native-multiplexer features, without leaving tmux.

Third look, again by omer-hamerman (Sept 11, before the TUIOS review): Omer adopts it as tmux plus agent control. Written in Rust by raine-virta. init detects installed agents and adds skills for commit, rebase, merge and PRs; trees land in a sibling <project>__worktrees directory. On the dashboard, d opens a diff and i turns an agent's preview into a live input; Tab shows a worktrees view where Shift-R sweeps merged trees. add -p "<prompt>" -a <agent> launches an agent in one command. Session mode feeds Omer's session manager (session-per-worktree). Two gripes: a vertical split by default (fixed in the pane config) and a merge command that doesn't fit merging on GitHub.

Second endorsement: omer-hamerman (DevOps Toolbox) closes the TUIOS review by naming workmux the preferred option, "the sweet spot of multiplexing, monitoring, and full terminal control".

Source: report · report · report

Linked from

Agent-native multiplexerAugment over replaceHerdrOmer Hamerman (DevOps Toolbox)Raine VirtaSam NataleSession per worktreeTUIOSWorktree per task