Skip to main content
The standard installer adds the plannotator command, checks the downloaded binary, and installs the hooks, skills, commands, and local runtimes used by detected coding agents.

​
Run the installer

The macOS and Linux installer supports x64 and Arm64. The Windows installers support x64 and Arm64 Windows. The full installer needs Git to fetch the current skills and command files. The optional integrated terminal also needs Node.js and npm. If that runtime cannot be installed, document annotation still works without the integrated terminal.

​
Verify the command

Open a new terminal if the installer changed your PATH, then run:
The help output lists the user-facing commands supported by the installed version.

​
Finish your agent setup

Choose your coding agent. The table shows what to do after the standard installer.

​
Install only the binary

Use a minimal install when you want the command without agent hooks, skills, commands, the optional sem semantic-diff sidecar, or the managed agent-terminal runtime.
--binary-only is an alias for --minimal in the shell installer. -BinaryOnly is the PowerShell alias. You can also set PLANNOTATOR_MINIMAL=1.

​
Pin or verify a release

Pin a release when you need a repeatable install:
Every installer checks the binary against its SHA-256 checksum. SLSA provenance verification is optional and requires an installed and authenticated GitHub CLI:
Windows provenance verification supports stable releases from v0.17.2 onward. The Windows installers reject prerelease tags when verification is enabled. Continue with annotating your first plan. Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026