kevinzai/commander/ao

/ao — Composio Agent Orchestrator

Wraps the ao CLI (@composio/ao). Spawns parallel agents across projects with git worktree isolation.

When activated:

Check if ao CLI is available:

which ao

If not found, display:

ao CLI not installed.
Run: npm i -g @composio/ao
Then re-invoke /ao once installed.

If found, check the version:

ao --version

Then present via AskUserQuestion:

Spawn Flow

When user picks "Spawn agents on current project":

1. Ask number of agents via AskUserQuestion:

• 2 agents
• 3 agents
• 5 agents
• Custom number

1. Ask model via AskUserQuestion:

• Claude (Recommended)
• Codex
• Aider
• OpenCode

1. Ask task assignment strategy via AskUserQuestion:

• One shared task (agents collaborate on the same goal)
• One task per agent (assign a separate task to each agent)
• Auto-split from description (describe overall goal, split automatically)

1. Collect task(s) — one per agent if individual, or one overall goal if auto-split.

1. Run the spawn command:

``bash ao spawn --agents [n] --model [model] --task "[task]" --worktree ``

1. Show spawned summary:

`` ao spawn complete Agents: [n] | Model: [model] | Worktree: isolated Task(s): Agent 1: [task] Agent 2: [task] ... ``

Spawn from Config File

When user picks "Spawn from config file":

1. Check for config:

``bash ls agent-orchestrator.yaml 2>/dev/null || ls .ao/config.yaml 2>/dev/null ``

1. If found, read and display the configured projects and agents.

1. Ask which project/config to run via AskUserQuestion.

1. Run:

``bash ao spawn --config [config_file] ``

Check Running Agents

ao status

Display the output formatted as a table. If no agents running: "No active ao sessions."

Stop Agents

ao stop

Confirm first: "This will kill all running ao sessions. Proceed?"

If user confirms, run the command and report result.

After every action, suggest next steps via AskUserQuestion:

Worktree Merge Helper

When user picks "Merge a worktree":

1. List worktrees:

``bash git worktree list ``

1. Ask which worktree to merge via AskUserQuestion.

1. Show the diff summary:

``bash git diff main...[worktree_branch] --stat ``

1. Ask: "Merge via PR or direct merge?"

• Create PR → run gh pr create with relevant context
• Direct merge → confirm then git merge [branch]

1. After merge, offer to prune the worktree:

``bash git worktree remove [path] ``