workmux

Run `workmux add <branch-name>` to create a git worktree, run configured file operations and hooks, and open a tmux window with your pane layout. Use `-b` to create it in the background and `-P <file>` to pass a prompt to the agent pane.

Create one worktree per task with `workmux add -b -P prompt.md`, optionally using `-n <count>` or `--foreach` for batches. Each worktree gets its own branch and tmux window, and you can monitor all agents with `workmux status` or `workmux dashboard`.

Yes, `workmux send` targets agents by worktree handle and searches all active agents globally if the handle is not in the current repo. Use `project:handle` syntax, such as `workmux send myproject:docs "update the API section"`, to disambiguate cross-project targets.

workmux auto-detects claude, gemini, codex, opencode, kiro-cli, and vibe in pane commands and injects prompts automatically. The `<agent>` placeholder in config resolves to whichever agent you set as the default.

By default `workmux merge` merges the branch into the base, deletes the tmux window, removes the worktree, and deletes the local branch. Use `--keep` to retain the worktree, window, and branch after merging.