skills.rest
ciaran-slow
ciaran-slowCOMMUNITY
Explore all skills by this author →
GitHub

workmux

Manage git worktrees paired with tmux windows as isolated parallel development environments.

Updated Aug 7, 2026
Search Tags:#cli#parallel agents#workflow orchestration#branch management#tmux#git worktree#workmux
One-click install
npx skills add https://github.com/ciaran-slow/MellowMaker --skill workmux-ciaran-slow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workmux
Source: https://github.com/ciaran-slow/MellowMaker/tree/main/.claude/skills/workmux
Command: npx skills add https://github.com/ciaran-slow/MellowMaker --skill workmux-ciaran-slow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Coordinating multiple parallel development tasks in one repository normally requires juggling branches, stashes, and terminal sessions by hand. This Skill provides the reference for the workmux CLI, which pairs each git worktree with a tmux window and an AI agent so parallel work stays isolated, trackable, and easy to merge or clean up. ## Core Features & Use Cases - Worktree lifecycle management: Create, list, open, merge, and remove git worktrees with a single command, including prompt injection for AI agent panes and idempotent re-opening. - Agent orchestration: Check agent status, wait for completion, capture terminal output, send follow-up instructions, and run shell commands inside another agent's worktree. - Operational recovery guidance: Documented fixes for stale pane state files, post-crash session resumption, failed pushes after merge, and submodule data-loss risks before bulk removal. - Use Case: Dispatch three bug-fix tasks in parallel by writing prompt files and running workmux add -b -P <file> for each, then monitor progress with workmux status and merge each branch when its agent reports done. ## Quick Start Ask the assistant to create a new workmux worktree for a branch named fix-login with a prompt describing the task, then check its progress with workmux status.

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 the worktree, run setup hooks, and open a tmux window with your configured agent. Use `-b` for background creation, `-P <file>` to pass a prompt file, and `-o` to reopen an existing worktree idempotently.

How do I dispatch parallel tasks to multiple AI agents in worktrees?▼

Write a prompt file per task and run `workmux add -b -P <file>` for each branch. Monitor progress with `workmux status`, read output with `workmux capture <handle>`, and send follow-ups with `workmux send <handle> "message"`.

Why does workmux status fail with malformed live pane information?▼

workmux keeps a stale per-pane state file for a tmux pane that no longer exists after a merge, removal, or crash. Delete the matching file in ~/.local/state/workmux/agents/ for the dead pane id, then retry the command.

Can workmux remove worktrees safely when the repo has submodules?▼

workmux clones submodules into each worktree, so removal destroys any unpushed submodule commits. Before bulk removal, run `git submodule foreach` with status and unpushed-log checks in every worktree and stop if anything is dirty or unpushed.

What should I check after workmux merge or a tmux crash?▼

Verify the commit actually reached origin/main with `git log origin/main`, since a rejected push can be silent. After a crash, run `workmux resurrect`, resume the real session by id with `claude --resume`, and regenerate pane status files.

Related Skills

Explore More Software Engineering Skills→
raineraine
2.4k

workmux

Manages git worktrees paired with tmux windows for parallel agent development.

Community
Intermediate
crowicrowi
1.1k

integrate-worktree

Merges finished git worktree branches into main, closes worktrees, and runs post-merge quality checks.

Official
Advanced
wan-huiyanwan-huiyan
3

parallel-pr-scope-overlap-tiebreaker-delta-check

Audits diffs of two scope-overlapping parallel PRs before applying merge tiebreaker rules.

Community
Intermediate
matheushenriquefsmatheushenriquefs

mentat-git

Automate Git commits and rebases within devcontainers using worktree slices.

Community
Intermediate