> ## 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.

# Use Plannotator with Pi

> Install the Plannotator Pi extension and use plan mode, code review, document annotation, and last-message review.

Pi uses its own Plannotator extension. You do not need the standard Plannotator installer for this setup.

## Install

```bash theme={null}
pi install npm:@plannotator/pi-extension
```

Pi 0.74.0 or later is required.

## Enter plan mode

Start Pi in plan mode:

```bash theme={null}
pi --plan
```

You can also run `/plannotator` or press `Ctrl+Alt+P` during a session. The command accepts an optional plan-file path.

In plan mode, the agent writes a Markdown plan and calls `plannotator_submit_plan`. Plannotator opens the plan for approval or annotated feedback. After approval, Pi enters execution mode and tracks checklist progress.

## Manual commands

```text theme={null}
/plannotator-review
/plannotator-annotate path/to/spec.md
/plannotator-last
```

`/plannotator-review` uses the detected Git, GitButler, or Jujutsu provider. Pass `--git` or `--gitbutler` to force one. GitButler review requires `but` 0.21.0 or later on `PATH`.

## Try without installing

```bash theme={null}
pi -e npm:@plannotator/pi-extension
```

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