Skip to content

Allow toggling Plan Mode in VSCode Companion #1985

@tanzhenxin

Description

@tanzhenxin

What would you like to be added?

The VSCode Companion extension should allow users to toggle Plan Mode from its approval mode cycle, matching the behavior available in the CLI.

In the CLI, users can cycle through all four approval modes via Shift+Tab, including Plan Mode. However, in the VSCode Companion, the mode toggle button only cycles through three modes — Default → Auto-edit → YOLO — with Plan Mode excluded entirely.

Plan Mode should be accessible from the VSCode Companion's mode toggle, so users can enter and exit it without leaving the IDE.

Additionally, the VSCode Companion should properly handle the plan approval prompt. In the CLI, when Plan Mode is active, the agent presents its plan via the exit_plan_mode tool and the user is prompted with three choices:

  • Proceed Once — approve the plan and switch to Default mode for execution
  • Proceed Always — approve the plan and switch to Auto-edit mode for execution
  • Cancel — reject the plan and stay in Plan Mode

The VSCode Companion should present an equivalent approval UI when the agent finishes its plan, so users can review, approve, or reject the plan directly from the IDE.

Why is this needed?

  • Feature parity with CLI. Plan Mode is a first-class approval mode in the CLI, but VSCode Companion users cannot access it without switching to the terminal.
  • Safer AI-assisted workflows. Plan Mode lets users review the agent's proposed plan before any file modifications or command executions. This is especially valuable in IDE workflows where users want to understand the agent's approach before committing to changes.
  • No workaround from IDE. Users working primarily in VSCode have no way to enter Plan Mode from the companion UI — they must use CLI settings or the terminal, which breaks their workflow.

Additional context

  • The CLI supports four approval modes: Plan, Default, Auto-edit, and YOLO. All four are accessible via keyboard shortcut in the terminal. The VSCode Companion currently only exposes three of them in its UI toggle.
  • The full Plan Mode workflow has two parts: (1) toggling into Plan Mode, and (2) the plan approval prompt when the agent finishes planning. Both need to work in the VSCode Companion for the feature to be complete.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions