Plan mode

Plan mode is a way to agree on the approach before Oda changes anything: Oda explores the task first, presents its plan for your review, and carries the plan out only after you approve. Use it for larger tasks, where the approach matters more than speed.

Turn plan mode on

  1. In the message box, type /plan, or choose Plan from the Command menu (the + menu in the message box). Commands are listed in Chat with Oda.
  2. To give Oda the task together with the switch, add it after the command, for example /plan prepare the quarterly review. Any text after /plan passes to Oda as the task; a bare /plan simply turns the mode on.
  3. Attachments are allowed when you enter plan mode, so you can add files to the message if the task needs them.
  4. The chat confirms the switch. When Oda is idle, plan mode is on at once: Plan mode on. Use /plan off to leave. While a step is already running, it applies from the next step: Entering plan mode (applies from the next step). Use /plan off to leave.

While plan mode is on, a Plan chip shows in the message box, and the hint there invites you to describe your task so Oda can draft the plan.

Review and approve the plan

With plan mode on, Oda explores first, then presents its plan for review in the chat. The plan appears as a Plan review card, and takes its title from the plan's first heading (or Plan when it has none). The review asks one question: Approve this plan and leave plan mode?

To approve, choose Approve itself: approving takes exactly that choice and no written answer. Reading the full plan, and the card's other controls, are covered in Plan review and questions.

Turn plan mode off

  1. Click the Plan chip in the message box, or type /plan off. The chip's icon becomes a cross when you point at it, showing that pressing it turns the mode off.
  2. The chat confirms the switch: Plan mode off. when Oda is idle, and Leaving plan mode (applies from the next step). while a step is running.
  3. If you changed your mind, /plan off also cancels an entry that has not taken effect yet: Plan mode entry cancelled. When the mode is already off, the chat answers Plan mode is already inactive.

What plan mode does not do

Questions, answered

How do I turn plan mode on?

Type /plan in the message box, or choose Plan from the Command menu. Add your request after it (/plan ...) so Oda starts with the task, or run it bare and describe the task in your next message. Attachments are allowed with the entry, and the chat confirms the switch.

How do I turn it off?

Click the Plan chip in the message box, or type /plan off. You can leave this way at any time, including when no plan review appears. If an entry has not taken effect yet, /plan off cancels it, and the chat answers Plan mode entry cancelled.

What if I want changes to the plan, not approval?

Choose Keep planning in the review: Oda stays in plan mode, takes your feedback, and presents a revised plan. If you close the review to type instead, Oda also stays in plan mode and waits for your message.

Does plan mode stop Oda from changing my files?

No. Plan mode is guidance, not a lock: every tool stays available. What Oda may change without asking you is set by the chat's access mode and its approval prompts; see Command sandboxing and approvals.

When does a plan-mode change take effect?

When Oda is idle, the change is immediate. While a step is running, it applies from the next step, and the chat says so in its confirmation.

What happens if I leave the plan review unanswered?

Nothing is approved: the review waits, and Oda stays in plan mode until you answer it or write a message. Closing the review to type does not approve the plan.

Can I attach files when I turn plan mode on or off?

Attachments are allowed when you enter plan mode. They are refused with /plan off, and the mode does not change: Attachments cannot accompany /plan off.

Can I start a new chat in plan mode?

No. There is no plan option when a chat is created; open the chat and run /plan.

Does plan mode stay on when I reopen the chat?

Yes. The mode is part of the chat: it survives a restart, and it reads the same in every tab.

Can a helper show me a plan review?

No. A helper that is still running cannot open a plan review card for you.