coordinator

Orchestrate multiple git worktree agents via workmux CLI commands.

4|Updated Sep 30, 2024
One-click install
npx skills add https://github.com/okm321/dotfiles --skill coordinator-okm321
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coordinator
Source: https://github.com/okm321/dotfiles/tree/main/claude/skills/coordinator
Command: npx skills add https://github.com/okm321/dotfiles --skill coordinator-okm321

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple parallel coding agents across separate git worktrees requires manual tracking of branches, statuses, and merges. This Skill turns the AI into a dispatcher that spawns, monitors, instructs, and merges worktree agents through the workmux CLI without implementing tasks itself. ## Core Features & Use Cases - Agent Spawning: Write self-contained prompt files and launch background agents with workmux add, each in its own git worktree and branch. - Monitoring & Communication: Check agent statuses, wait for completion with timeouts, capture output, and send follow-up instructions or skill commands like /merge. - Cross-Project Targeting: Address agents in other repositories using global handle resolution or project:handle syntax. - Use Case: Split a feature into backend, tests, and docs tasks, spawn three agents in parallel, wait for all to finish, review their captured output, then merge each branch sequentially. ## Quick Start Ask the AI to coordinate worktree agents by spawning parallel agents for your subtasks, waiting for them to finish, and merging their branches one at a time.

Frequently Asked Questions about coordinator

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

FAQPage Schema
How do I run multiple Claude Code agents in parallel?▼

Write a self-contained prompt file for each task, then spawn agents with `workmux add <handle> -b -P <file>`. Each agent runs in its own git worktree and tmux window, and you monitor them with `workmux status` and `workmux wait`.

How do I merge branches from parallel worktree agents?▼

Send each agent the `/merge` command via `workmux send <handle> "/merge"` so the agent handles rebasing and conflict resolution itself. Merge one agent at a time and wait for each to finish to avoid conflicts.

Can workmux agents in different projects communicate?▼

Yes, agent commands like send, capture, status, wait, and run resolve handles globally across projects. Use `project:handle` syntax to disambiguate when the same handle name exists in multiple repositories.

Why does workmux wait time out before agents finish?▼

The wait command exits with code 1 when the timeout expires before agents reach the target status. Increase the `--timeout` value in seconds, or check `workmux capture` output to see if an agent is stuck or waiting for input.

What are the limitations of the coordinator agent pattern?▼

The coordinator never reads source files or implements tasks itself; it only dispatches and monitors. Agents cannot see the coordinator's conversation, so every prompt file must be fully self-contained with relative paths and verbatim context.