Plan Mode

Plan mode lets you see what Commander will do before it does it. Switch to plan mode to review the execution strategy, agent allocation, and tool calls — with zero risk of unintended changes.

Why Use Plan Mode

• Safety — Review the full plan before any files are modified
• Learning — Understand how Commander decomposes and approaches tasks
• Debugging — See which topology, agents, and tools will be used
• Collaboration — Share and iterate on the plan with team members

Usage

From monorepo source; after build use commander instead of npx tsx packages/core/src/cliEntry.ts.

# Set plan mode
npx tsx packages/core/src/cliEntry.ts mode plan

# Then run any task
npx tsx packages/core/src/cliEntry.ts run "refactor the database layer"

# Or use the --plan flag for one-off plan mode
npx tsx packages/core/src/cliEntry.ts plan "implement search feature"

Plan Output

When you run a task in plan mode, Commander shows:

┃ → Deliberating task...
┃ → Complexity: HIGH (score: 72/100)
┃ → Topology: ORCHESTRATOR
┃ → Agents: 4 (1 lead + 3 specialists)
┃ → Provider: deepseek (fallback: openai → anthropic)
┃ → Token budget: 100,000
┃
┃ → Subtasks:
┃   1. Analyze existing database schema
┃   2. Design migration plan
┃   3. Implement changes (parallel: 2 agents)
┃   4. Verify and test
┃
┃ → Estimated duration: 45s
┃ → Total tools calls: ~12

Visual Indicator

The terminal shows a plan mode indicator in the lower-right corner when active, so you always know whether Commander is in plan or execution mode.