Skip to main content
Select lines in a code diff and choose Ask AI to ask a question about that code. The answer streams into the AI sidebar and stays attached to the file in the chat history. You can also ask a general question from the AI tab. Plannotator includes the current comparison in the request, such as uncommitted changes, a branch comparison, a Jujutsu revision, a GitButler stack, or a pull-request checkout. When you switch the comparison, the next question receives the new review context. Ask AI is an explanation tool. Its conversation is separate from your annotations and final review. Copy a useful conclusion into a normal annotation if you want it included when you send feedback.

​
Configure a provider

Plannotator detects supported AI providers from their local command-line tools. Install and authenticate or configure at least one provider before opening the review. Plannotator does not create accounts or manage provider API keys. If a provider is detected but cannot answer, verify its authentication and model configuration by running its CLI directly. Open Settings > AI to choose a provider and model. The choice persists across sessions. When possible, Plannotator initially prefers the provider that matches the agent that opened the review: Claude Code uses Claude, Codex uses Codex, OpenCode uses OpenCode, and Pi uses Pi. Other invoking agents use the saved choice or available server default. Changing the provider or model starts a new AI session. Earlier messages remain visible, but they are not part of the new provider conversation.

​
Ask a focused question

  1. Select the smallest useful line range in the diff.
  2. Choose Ask AI in the annotation toolbar.
  3. Ask a concrete question about behavior, risk, or intent.
  4. Verify the answer against the patch and repository before turning it into review feedback.
For example:
The selected lines are included even when the overall diff must be shortened to fit the provider’s context window.

​
Pull requests need a local checkout

Ask AI can read local-change reviews immediately. For a GitHub pull request or GitLab merge request, it needs the temporary local checkout that Plannotator prepares by default. If preparation is still running, retry after it finishes. Ask AI is unavailable for a pull-request review started with --no-local, because that mode intentionally retains only the provider diff. See Review pull requests and merge requests for the checkout boundary. Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026