workmux

Manages git worktrees paired with tmux windows as isolated development environments.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill workmux-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workmux
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/workmux
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill workmux-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating parallel development work across multiple branches requires juggling git worktrees, tmux windows, and AI agent sessions manually, which is error-prone and hard to track. ## Core Features & Use Cases - Worktree and window lifecycle: Create, list, open, close, and remove git worktrees paired with tmux windows using commands like workmux add, workmux list, and workmux remove. - Agent orchestration: Check agent status, wait for completion, capture terminal output, and send instructions to agents running in other worktrees via workmux status, workmux wait, workmux capture, and workmux send. - Merge and cleanup: Merge branches with rebase or squash strategies and clean up worktrees, windows, and branches in one step using workmux merge. - Use Case: Dispatch three parallel AI agents to fix separate bugs by running workmux add with prompt files, monitor them with workmux status, then merge each finished branch back into main. ## Quick Start Ask the assistant to create a new workmux worktree for a branch named fix-login with a prompt describing the bug to fix.

Frequently Asked Questions about workmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a git worktree with a tmux window using 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 without switching, or `-P <file>` to pass a prompt file to an AI agent pane.

How do I run multiple AI agents in parallel worktrees?

Use `workmux add` with `-n <count>` for multiple instances or `--foreach` for a variable matrix, each with its own prompt. Monitor them with `workmux status`, wait with `workmux wait`, and send follow-up instructions with `workmux send <handle>`.

Which AI agents does workmux support?

workmux auto-detects built-in agents including claude, gemini, codex, opencode, kiro-cli, and vibe in pane commands, injecting prompts automatically. The default agent is set via the `agent` key in the global or project YAML config.

How do I merge a worktree branch and clean up afterwards?

Run `workmux merge` from the worktree, or `workmux merge <branch>` for a specific branch. It merges into the base branch, deletes the tmux window, removes the worktree, and deletes the local branch; use `--keep` to preserve them.

Can workmux create worktrees in a different project?

Yes, but `workmux add` operates on the current repo and tmux session, so you must run it inside the target project's tmux session. Discover sessions with `tmux list-sessions` and dispatch with `tmux new-window -t <session> -c <project-path>`.