Skip to main content
The plannotator command opens a local review session in your browser. Run plannotator <command> --help for the help text shipped with your installed version.

​
Review code changes

With no URL, Plannotator reviews changes in the current repository. It detects Git, GitButler, Jujutsu, or Perforce. Use --git or --gitbutler to override detection. GitButler support requires but 0.21.0 or later. Jujutsu is detected through the installed jj command and does not have a separate flag. Pass a GitHub pull request or GitLab merge request URL to review it. Plannotator prepares a local checkout by default so it can show complete files. Use --no-local for a diff-only review.

​
Annotate a file, URL, or folder

Markdown and text open as documents. Local HTML renders as HTML by default; --markdown converts it to Markdown. A folder opens the supported Markdown, text, and HTML files it contains. URLs use Jina Reader by default. --no-jina uses a direct fetch followed by local HTML-to-Markdown conversion. --gate adds an Approve action. --json writes a machine-readable decision to standard output. --hook implies --gate and writes the hook-native block/pass contract described in Hooks.

​
Annotate the last agent message

The command reads the last assistant message from a supported agent session. Use --stdin to supply the text yourself:
last is an alias for annotate-last.

​
Reopen a running session

sessions lists live local servers. --open [N] opens the numbered session, with session 1 as the default. --clean removes stale session records.

​
Read saved plan decisions

This opens the read-only archive for decisions saved under ~/.plannotator/plans/, or the equivalent directory under PLANNOTATOR_DATA_DIR.

​
Goal setup commands

This command belongs to the installed /goal workflow. interview opens goal questions; facts opens the facts acceptance view. Pass - to read the bundle JSON from standard input.

​
Global options and hook-only commands

  • --browser <name> selects a browser, application, or executable for this run. It can appear with any command.
  • --version and -v print the installed version.
  • plannotator improve-context is called by an installed agent hook. It reads a hook event from standard input and is not intended for direct use.
Running plannotator without arguments also belongs to hook integration and expects JSON on standard input. For an interactive session, choose review, annotate, last, archive, or sessions explicitly. Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026