Browse docs

Desktop App

Agent modes

Agent modes control autonomy and confirmation behavior, so you can trade speed for control by task phase.

Mode overview

  • Build: default execution mode for practical implementation loops.
  • Plan: planning-first behavior that emphasizes exploration and structured plans.
  • Agentic (YOLO): high-autonomy mode for rapid end-to-end execution.

Permission behavior by mode

  • In local Spatial harness sessions, Build and Plan require tool confirmations by default.
  • In local Spatial harness sessions, Agentic (YOLO) auto-approves tool confirmations by default.
  • Hook policy checks are evaluated first in local harness flows; hook auto-approve/require-confirm rules can override mode defaults.
  • In server-streamed session flows, exec/file operation confirmations are auto-approved and question-style confirmations still require user input.

What each mode emphasizes

  • Plan mode prompts the agent to investigate, ask clarifying questions, and prepare structured execution plans.
  • Build mode prompts the agent to execute implementation work with full tooling and quality checks.
  • Agentic mode prompts autonomous execution and confirmation-free momentum.

Selection playbook

  • Start in Plan when scope is unclear or high-risk.
  • Move to Build for day-to-day implementation and verification.
  • Use Agentic for tightly-scoped tasks where you explicitly want speed over guardrails.

Mode support on local CLI models

Claude Code and Codex local CLI models expose the same three user-facing modes: Build, Plan, and Agentic.

When switching models, unsupported or invalid mode selections are normalized back to supported defaults to keep sessions runnable.