Plan first.
Use `/plan` when the task touches files, carries risk, or needs user review.
Docs
Slash commands.
Control the real agent runtime without leaving the TUI or Mac canvas.
picasso / docs / commandsindexed
Docs
Slash commands
Control the real agent runtime without leaving the TUI or Mac canvas.
Plan firstUse `/plan` when the task touches files, carries risk, or needs user review.
Escalate to goalUse `/goal` when the work has clear completion criteria and may take multiple loops.
Keep context cleanUse `/memory` to inspect what the agent will retrieve, and `/replay` to verify what the agent actually used.
TriggerDescriptionExample/planEnter read-only architecture mode and draft a reviewable plan./plan add tests for auth./goalStart or control a long-running objective with criteria and evidence./goal migrate js to ts./memoryOpen, add, remember, pin, unpin, or delete runtime memory./memory pin use vitest.
/mode safe/mode auto/mode paranoidThe essentials.
| Trigger | Description | Example |
|---|---|---|
| /plan | Enter read-only architecture mode and draft a reviewable plan. | /plan add tests for auth. |
| /goal | Start or control a long-running objective with criteria and evidence. | /goal migrate js to ts. |
| /memory | Open, add, remember, pin, unpin, or delete runtime memory. | /memory pin use vitest. |
| /auth | Open authentication and provider state. | /auth |
| /mcp | Manage MCP servers. | /mcp install github. |
| /subagent | List, launch, fork, or inspect scoped subagents. | /subagent reviewer. |
| /replay | Open session, goal, provider, tool, approval, and memory evidence. | /replay latest. |
| /mode | Switch permission mode for the session. | /mode paranoid. |
| /provider | Switch model route. | /provider openai. |
| /model | Switch or inspect the current routed model. | /model qwen3-coder. |
| /verify | Run configured checks or plan verification. | /verify. |
| /diff | Show the current workspace diff. | /diff. |
| /undo | Back out the last accepted write batch when supported. | /undo. |
| /commit | Prepare a commit message after verification. | /commit. |
Where they fit.
Escalate to goal.
Use `/goal` when the work has clear completion criteria and may take multiple loops.
Keep context clean.
Use `/memory` to inspect what the agent will retrieve, and `/replay` to verify what the agent actually used.
Split work.
Use `/subagent` when investigation, review, tests, browser checks, or docs can happen in parallel.
Editing and review.
| Command | Use |
|---|---|
| /diff. | Show the current workspace diff. |
| /verify. | Run configured checks or the checks named in the plan. |
| /undo. | Back out the last accepted write batch when supported. |
| /commit. | Prepare a commit message after verification. |
Policy commands.
Mode commands change how much Picasso can do without asking. Sponsor commands explain or block labeled sponsor surfaces. Memory, replay, provider, and subagent commands expose runtime state instead of hiding it behind chat. These choices stay visible in the TUI and Mac app so the current boundary is never implied.
/mode safe/mode auto/mode paranoid/memory/replay latest/subagent/sponsors why/sponsors block <sponsor>Same controls in the Mac app.
The Mac app does not run a separate product. Its screens for memory, plans, goals, replay, modes, approvals, providers, MCP, and subagents call the same local helper and runtime state as the CLI/TUI.
Memory.
Mac memory writes appear in CLI and TUI memory views.
Goals.
Goal start, pause, resume, cancel, and replay share the same backend ledger.
Approvals.
Write approvals and destructive confirmations keep the same policy semantics.
Related docs.
CLI reference.
Non-interactive command equivalents.
Hooks.
Project-level policy around command execution.
Security.
Permission modes, sandboxing, and audit logs.