urmzd/dotfiles / dot_agents/skills/orchestrate-agents
orchestrate-agents
VerifiedOrchestrate multiple agent CLIs (Claude, Codex, Antigravity) via tmux with a shared fleet store, dispatching one guardian subagent per pane. Survey-first: inspects and adopts existing tmux sessions, windows, and agent panes before creating anything new. Use when running a multi-agent session, dispatching parallel work, or coordinating subagents across panes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.6 KB |
| references/agent-clis.md | markdown | 3.5 KB |
| scripts/executable_fleet.shexecutable | script | 15.0 KB |
references/agent-clis.md
View on GitHub# Agent CLI matrix
Per-tool launch, headless, auto-approve, and resume flags for the four agent
CLIs the orchestrator can spawn. Always confirm a tool's current flags with
`<tool> --help`; CLIs change. Launch agents **bare and interactive** by default
so their own permission prompts stay on (the careful default). Add auto-approve
flags only when the run is explicitly opted into a less careful safety mode.
## Preference order
When a workstream does not pin a specific tool, pick in this order based on
what is installed: **1. claude**, **2. codex**, **3. copilot**, **4. agy**.
`fleet.sh spawn ... auto` and `fleet.sh resolve_tool` already encode this.
## claude (Claude Code)
| Need | Command |
|------|---------|
| Interactive | `claude` (optionally `-n <name>`, `--model <m>`, `--effort <level>`, `--add-dir <d>`, `--agent <a>`) |
| Headless | `claude -p "<prompt>" [--output-format json]` |
| Auto-approve edits | `claude --permission-mode acceptEdits` |
| Full auto | `claude --dangerously-skip-permissions` |
| Resume | `claude -c` (continue) or `claude -r <id>` |
**Blocked-on-permission UI:** a bordered prompt ending in `Do you want to proceed?`
with numbered choices like `❯ 1. Yes`. Send `1` + Enter to approve once told to.
## codex (OpenAI Codex)
| Need | Command |
|------|---------|
| Interactive | `codex` (or `codex "<prompt>"` to seed the first turn) |
| Headless | `codex exec "<prompt>"` |
| Approval / sandbox | `codex --ask-for-approval <on-request\|never> --sandbox <mode>` |
| Full auto | `codex --full-auto` |
| Bypass everything | `codex --dangerously-bypass-approvals-and-sandbox` |
| Resume | `codex resume --last` |
**Note:** the npm package ships a vendored native binary; if `codex exec` errors
with `ENOENT` on the vendor path, the install is broken for this architecture.
Run `codex --version` in `doctor` follow-up before relying on it.
## copilot (GitHub Copilot CLI)
| Need | Command |
|------|---------|
| Interactive | `copilot` (optionally `--add-dir <d>`, `--effort <level>`, `--agent <a>`) |
| Headless | `copilot -p "<prompt>" --allow-all-tools` (non-interactive requires allow-all-tools) |
| Auto-approve tools | `copilot --allow-all-tools` |
| Full auto | `copilot --allow-all` (tools + paths + urls) |
**Blocked-on-permission UI:** asks to allow a tool/command; confirm per its prompt.
## agy (Antigravity CLI, replaces legacy Gemini CLI)
| Need | Command |
|------|---------|
| Interactive | `agy` (`--model <m>`, `--add-dir <d>`) |
| Prompt then interactive | `agy -i "<prompt>"` |
| Headless | `agy -p "<prompt>"` (`--print-timeout <dur>`, default 5m) |
| Full auto | `agy --dangerously-skip-permissions` |
| Sandboxed | `agy --sandbox` (terminal restrictions) |
| Resume | `agy -c` (most recent) or `agy --conversation <id>` |
No granular approval-mode flags as of 1.0.5; per-command allow/deny lists are
managed in-app via `/permissions`.
## State-detection patterns
`fleet.sh classify` greps the recent pane buffer for these. Extend the regexes in
the script if a tool's wording drifts.
- **needs-permission:** `Do you want to`, `Allow`, `Proceed?`, `(y/n)`, `[y/N]`,
`❯ 1. Yes`, `Approve`, `requires approval`, `Continue?`.
- **error:** `Error`, `panic`, `Traceback`, `command not found`, `not logged in`,
`Unauthorized`, `rate limit`, `quota exceeded`, `usage limit`, `context length`.
- **idle:** pane buffer unchanged for `FLEET_IDLE_SECS` (default 30s) and matching
no prompt pattern. Often means done, or genuinely stuck. Verify with the
transcript via `agentspec session export <tool> --last`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |