Plan mode

When to use it

Use plan mode for multi-step code changes, risky edits, unclear scope, or work where you want to approve the approach before tools run.

For small questions and simple one-file changes, normal chat is usually faster.

Entering plan mode

Type /plan-mode in the chat editor or select it from the slash menu. The toolbar shows a Plan Mode badge while it is active. External-agent threads do not expose the native slash item.

Tool access while planning

The native runtime exposes a reduced tool set while planning. It can inspect project context and use read-oriented tools such as notes and tasks queries, but write tools for notes and tasks are not exposed in plan mode.

Implementing

When a draft plan artifact appears, open it and click Implement the plan. The implementation turn runs with full file-editing tools and still respects the current permission mode for approvals.

Persistence

Plan artifacts are saved with the session. Reopening the thread shows the plan title, path, content, and status: draft, implemented, or rejected.