Commands

Commands

/setup

Configures recommended settings — sets quietStartup: true in ~/.pi/agent/settings.json.

/setup

• Reads existing settings.json if present (preserves other settings)
• Shows a confirmation dialog before making changes
• Skips if quietStartup is already true

/clarify

Starts agentic-clarification — the agent asks dynamic, context-aware questions one at a time to resolve ambiguity.

/clarify [topic]

• The agent explores the codebase in parallel via subagents while asking questions
• Ends with a structured Context Brief (scope, constraints, success criteria, complexity assessment)
• Optionally pass a topic: /clarify add user authentication

/plan

Generates an executable implementation plan following the agentic-plan-crafting skill rules.

/plan [topic]

• Transforms the Context Brief (or current context) into an implementation plan
• Every step has exact file paths, code blocks, commands, and expected outputs
• No placeholders — every step is immediately executable

/ultraplan

Decomposes a complex task into milestones via multi-agent review.

/ultraplan [topic]

• Composes a Problem Brief
• Dispatches 5 reviewer agents in parallel: Feasibility, Architecture, Risk, Dependency, User Value
• Synthesizes findings into an optimized milestone DAG

/reset-phase

Resets the workflow phase to idle (clears /clarify, /plan, /ultraplan mode).

/reset-phase

Use this when switching between workflow types without restarting pi.

/ask

Manual smoke test for the ask_user_question tool.

/ask [topic]