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.

Source: report

Linked from

Agent-native multiplexerAugment over replaceHerdrSam NataleWorktree per task