These instructions are for VS Code. If you’re using a VS Code-compatible editor
like Cursor or Windsurf, the steps are similar but may require adaptation.
Requirements
- The CodeRabbit VS Code extension installed, and you are signed in to CodeRabbit.
- A Pro+ or Enterprise plan. Other plans see an upgrade prompt in the Plans tab.
- The repository open in your workspace must be installed in your CodeRabbit organization. If it isn’t, the Plans tab links you to the repository settings so you can install it first.
Create a plan
Open the Plans tab
Click the CodeRabbit icon in the VS Code activity bar, then select the
Plans tab in the sidebar.
Describe what you want to build
Type a description of the feature, bug fix, or change in the composer at the
bottom of the tab. Include goals, scope, and constraints. The more context
you provide, the better the plan.
Reference workspace files (optional)
Type
@ or click the mention button to reference files and folders from
your workspace. Referenced files are included as context, and folder
references include the files inside them.Attach supporting documents (optional)
Click the paperclip icon to attach PRDs, design specs, or screenshots.
Supported formats include text, Markdown, CSV, JSON, PDF, and common image
types, with up to 10 attachments of 5 MB each.
Browse plans
The Plans tab lists the plans for the connected repository, newest first. Each entry shows the plan title, its status, the number of phases, and when it was created. Use the Search plans box to filter by title, and click any plan to open its details.Review plan details
The plan view shows everything CodeRabbit generated, in the same structure as the web app:- Summary: An overview of the planned change.
- Research: Key findings from CodeRabbit’s codebase analysis.
- Assumptions: The assumptions CodeRabbit made, with the chosen options and rationale.
- Coding Plan: The implementation phases. Expand a phase to see its description, task list, and the AI prompt, which you can copy for use with any agent.
Implement a plan
Select phases
Check the phases you want to implement, or use Select all. Handing off
one phase at a time often works better for complex plans.
Click Implement
Click the Implement button to send the selected phases’ prompts to your
configured AI coding agent: Copilot, Claude Code, Codex CLI, OpenCode,
Cline, Roo, Kilo Code, Augment Code, or the clipboard as a fallback.
Configure your preferred agent in extension
settings.
Refine a plan on the web
Click Iterate on Web in the plan view to open the plan in the CodeRabbit web app, where you can refine it through chat and collaborate with your team. When you return to the editor, the Plans tab picks up the updated plan. This works in the other direction too: the Send to IDE option in the web app’s Agent Handoff opens the plan directly in your editor.What’s next
CodeRabbit Plan overview
Learn how Coding Plans work and the other ways to create them
Configure the extension
Customize automatic review behavior and AI agent integration