openai / openai/codex

[VS Code] Add inline comments and annotations to Plan mode plans

Open
#39,920 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement extension plan
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

What variant of Codex are you using?

VS Code Extension

What feature would you like to see?

Please add inline comments and annotations to generated Plan mode plans in the Codex VS Code extension.

After Codex generates a plan, the user should be able to select a specific heading, paragraph, or list item and attach a comment to that exact fragment.

The extension should allow multiple annotations to be collected and submitted together in a single chat message, with each comment retaining the selected plan text as context.

Current behavior

The user can either accept the entire plan or provide a general free-form response asking Codex to change it.

For a large plan, this forces the user to manually quote or restate every relevant section and explain which comment belongs to which part of the plan. This is slow, ambiguous, and makes Plan mode impractical for reviewing non-trivial implementation plans.

Requested behavior
  • Allow selecting text inside a generated Plan mode plan.
  • Provide an Add comment action for the selected fragment.
  • Allow multiple comments on different plan fragments.
  • Show the selected fragments and their comments in the chat composer.
  • Submit all annotations to Codex in one turn.
  • When revising the plan, preserve unaffected sections instead of regenerating unrelated details.

This should work similarly to inline comments during code or document review.

Why this matters

The primary value of Plan mode is reviewing and correcting an implementation approach before any code is changed.

Without comments tied to specific plan fragments, reviewing a large plan becomes harder than reviewing the resulting code. Inline annotations would make the planning workflow precise, collaborative, and usable for real implementation work.

Related issues
  • #35918 requests the same inline annotation workflow for Codex Desktop.
  • #35272 requests an "Implement with changes" workflow for the VS Code extension.
  • #14463 was an earlier request for direct Plan mode review and editing.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the VS Code extension's Plan mode flow and reviewing related issues #35918, #35272, and #14463. Done means users can select plan fragments, attach multiple comments, review the collected annotations in the chat composer, submit them together, and preserve unaffected plan sections during revision.

Written by the indexing model from the issue text.

Assessment

Tech stack
vscode
Domain
developer-experience, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.