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

# Review Your First Code Change

> Open a local code diff in Plannotator, comment on changed lines, and send clear feedback to your coding agent.

Use a project where you or your coding agent has changed code. Plannotator opens the diff in your browser so you can comment on exact lines and send feedback to your agent.

<Steps>
  <Step title="Open a project with code changes">
    In your terminal, go to a Git, GitButler, Jujutsu, or Perforce project with changes to review.

    For your first review, use a project where an agent has just finished a task. You do not need to commit the changes first.
  </Step>

  <Step title="Open the code review">
    Run:

    ```bash theme={null}
    plannotator review
    ```

    Plannotator detects the project and opens the diff in your browser. In Git projects, the default view shows the code that a pull request would contain, including committed, staged, unstaged, and untracked changes.
  </Step>

  <Step title="Comment on a changed line">
    Select one or more changed lines. Add a comment, request a deletion, or suggest replacement code.

    Keep the feedback specific. State what should change and why.
  </Step>

  <Step title="Send the feedback">
    Select **Send Feedback**.

    A direct terminal run prints structured feedback that you can copy. When your coding agent starts the review, Plannotator returns the same feedback to that agent session.
  </Step>
</Steps>

## Start the review from your coding agent

Most command-based agents use:

```text theme={null}
/plannotator-review
```

Codex can run `!plannotator review` or use `$plannotator-review`. See [Agents](/open-source/agents) for the command and setup for Claude Code, Codex, OpenCode, Copilot CLI, Gemini CLI, Pi, Amp, Droid, and Kiro CLI.

## Review a pull request or merge request

Pass Plannotator a GitHub pull request or GitLab merge request URL:

```bash theme={null}
plannotator review https://github.com/owner/repository/pull/123
```

For comparison modes and source-control details, see [Review Local Code Changes](/open-source/workflows/local-changes). For provider setup and posting feedback, see [Review Pull Requests and Merge Requests](/open-source/workflows/pull-requests).

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.