> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a plan

> Create a Coding Plan from free-form descriptions, PRDs, designs, editor context, or attached files in the CodeRabbit web app, Issue Tracker or VS Code extension.

The [CodeRabbit web app](https://app.coderabbit.ai) and CodeRabbit VS Code extension let you create Coding Plans from free-form descriptions, PRDs, designs, editor context, or attached files, without going through an issue tracker. This is the fastest way to start planning when you already know what you want to build.

<Tabs>
  <Tab title="Web app">
    <Steps>
      <Step title="Open the New Plan page">
        Navigate to **Plan → New Plan** in the CodeRabbit web app, or go directly to [app.coderabbit.ai/plan/new](https://app.coderabbit.ai/plan/new).
      </Step>

      <Step title="Describe what you want to build">
        Enter a description of the feature, bug fix, or change you want to implement. Include goals, scope, and constraints. The more context you provide, the better the plan.
      </Step>

      <Step title="Attach files (optional)">
        Click the paperclip icon to attach supporting documents such as PRDs, design specs, architecture diagrams, or screenshots. Supported formats include text files, PDFs, and images.
      </Step>

      <Step title="Select the target repository">
        Choose the repository CodeRabbit should analyze when generating the plan. This ensures the plan references the correct files, patterns, and conventions.
      </Step>

      <Step title="Click Create plan">
        CodeRabbit analyzes your repository and connected data sources, then generates a full Coding Plan. Plan generation typically takes between 5 and 10 minutes depending on codebase complexity.
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    Use the CodeRabbit VS Code extension when the work starts in your editor and you want CodeRabbit to plan against the repository you already have open.

    <Steps>
      <Step title="Open the CodeRabbit sidebar">
        Click the CodeRabbit icon in the VS Code activity bar and open the Plan view.
      </Step>

      <Step title="Describe the work">
        Enter the feature, bug fix, or change you want to implement. Include goals, constraints, and any acceptance criteria you already know.
      </Step>

      <Step title="Select the target repository">
        Choose the repository CodeRabbit should analyze. The extension lists repositories that match the current workspace and your CodeRabbit organization access.
      </Step>

      <Step title="Add context files (optional)">
        Attach relevant files from your workspace when the plan should account for local code, specifications, or examples that are not obvious from the description alone.
      </Step>

      <Step title="Create the plan">
        Start plan generation from the extension. CodeRabbit streams progress in VS Code, then opens the created plan so you can review it, refine it, or open it in the web app.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Managing plans

Browse all plans for your organization from the [plans list](https://app.coderabbit.ai/plan/plans), where you can:

* **Search** by title or ticket ID to find existing plans.
* **View status** to see whether a plan is in progress, completed, or needs review.
* **Open a plan** to view its full structure, refine it through chat, or hand it off to a coding agent.

Plans created from VS Code appear alongside your other organization plans. The extension also keeps its local plan list refreshed when you return to the plan list.

## Configuration

If you also use issue-tracker-based planning, you can configure auto-planning rules and issue planning toggles from the CodeRabbit web app. These settings control when Coding Plans are generated automatically from issues on GitHub, GitLab, Azure DevOps, Jira, or Linear.

See the [issue-based planning guides](/issues/planner) for platform-specific auto-planning configuration.

## Next Step

<CardGroup cols={1}>
  <Card title="Plan structure and refinement" href="/plan/plan-refinement" icon="list-tree" horizontal>
    Learn what each section of a Coding Plan contains and how to iterate on it before handoff.
  </Card>

  <Card title="Use the VS Code extension" href="/ide/vscode-use" icon="square-code" horizontal>
    Create and review plans from the editor where your code context lives.
  </Card>
</CardGroup>