Plannotator

Follow @plannotator on X for updates

| Release | Highlights |
| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| v0.19.23 | Droid integration, Windows Pi AI fix, quieter update indicator |
| v0.19.22 | Safari copy fix in plan viewer, CLAUDE_CONFIG_DIR support for session logs |
| v0.19.21 | Ask AI in plan review and annotate mode, shared AI runtime, origin-aware provider defaults |
| v0.19.20 | Interactive goal setup UI, OpenCode submit_plan fixes, browser no-op sentinel handling for Claude agents |
| v0.19.18 | Edit-based submit_plan for OpenCode, Pi namespace migration, Codex annotate-last fix, OpenCode commands dir fix |
| v0.19.17 | Reworked goal setup skill (interview-driven flow), CLI --version flag |
| v0.19.16 | Code navigation with peek view (Cmd/Ctrl+click tokens in diffs) |
| v0.19.15 | Commit-based diff base, jj evolution diffs, GitLab reliability fixes, OpenCode command intercept fix |
| v0.19.14 | Visual explainer skill update, PFM code-file hover previews, Graphviz, diff tab size and line bg intensity, hooks settings tab |
| v0.19.11 | Jujutsu (jj) VCS backend, slimmer hunk separators, collapse viewed files, multi-line gutter selection fix |

What's New in v0.19.24

v0.19.24 adds Amp as a supported agent runtime, introduces a configurable data directory, adds Auto Mode to the permission dropdown, and fixes a Pi crash after plan approval. Five PRs, three from first-time contributors.

Amp Integration

Plannotator now supports Amp, the Amplify coding agent. The plugin runs as a native Amp extension with four command-palette actions: Review changes, Review changes or PR, Annotate file, and Annotate last answer. It spawns the plannotator CLI binary and communicates results back to the Amp thread.

The plugin ships as a single TypeScript file that Amp loads directly. Install it by copying it to ~/.config/amp/plugins/plannotator.ts after installing the CLI. For project-local use, place it at .amp/plugins/plannotator.ts.

• #803

Configurable Data Directory

A new PLANNOTATOR_DATA_DIR environment variable lets you relocate the ~/.plannotator/ data directory to any path. All data (plans, history, drafts, config, hooks, sessions) follows the override. This is useful for container setups, multi-user machines, or anyone who wants Plannotator's data in a non-default location. The variable supports tilde expansion and relative paths. When unset, everything works exactly as before.

• #795, contributed by @IstPlayer

Auto Mode Permission Option

The permission mode dropdown in Settings now includes Auto Mode, which maps to Claude Code's autonomous execution mode gated by a model-based safety classifier. This requires Claude Code 2026-03 or later and Sonnet 4.6 or later. On older Claude Code versions, selecting it has no effect. The existing permission modes (Default, Accept Edits, Bypass) are unchanged.

• #796, contributed by @BeamNawapat

Pi Plan Approval Fix

The Pi extension was crashing after a user approved a plan. The continuation message that tells the agent to proceed with the approved plan was sent via setTimeout, which delivered it outside the event handler's execution context. Pi's event model requires follow-up messages to be delivered synchronously using the deliverAs: "followUp" option. The fix replaces the deferred callback with the correct delivery mechanism.

• #805 closing #804, contributed by @xz-dev

Install / Update

macOS / Linux:

curl -fsSL https://plannotator.ai/install.sh | bash

Windows:

irm https://plannotator.ai/install.ps1 | iex

Claude Code Plugin: Run /plugin in Claude Code, find plannotator, and click "Update now".

OpenCode: Clear cache and restart:

rm -rf ~/.bun/install/cache/@plannotator

Then in opencode.json:

{
  "plugin": ["@plannotator/opencode@latest"]
}

Pi: Install or update the extension:

pi install npm:@plannotator/pi-extension

Droid: Install via the plugin marketplace:

droid plugin marketplace add backnotprop/plannotator
droid plugin install plannotator@plannotator

Amp: Install the CLI first, then copy the plugin:

mkdir -p ~/.config/amp/plugins
curl -fsSL https://raw.githubusercontent.com/backnotprop/plannotator/main/apps/amp-plugin/plannotator.ts \
  -o ~/.config/amp/plugins/plannotator.ts

What's Changed

• feat: add PLANNOTATOR_DATA_DIR env var to customize data directory by @IstPlayer in #795
• Add Auto Mode option to Permission Mode dropdown by @BeamNawapat in #796
• Add Amp plugin integration by @backnotprop in #803
• Fix Pi plan approval continuation delivery by @xz-dev in #805

New Contributors

• @IstPlayer made their first contribution in #795
• @BeamNawapat made their first contribution in #796
• @xz-dev made their first contribution in #805

Contributors

@IstPlayer built the PLANNOTATOR_DATA_DIR feature, which required touching nearly every shared module to replace hardcoded paths with the new resolver. @BeamNawapat added Auto Mode to the permission dropdown, wiring Claude Code's autonomous execution mode through the hook protocol. @xz-dev both reported and fixed the Pi plan approval crash, tracing the root cause to Pi's event delivery model and shipping the correct deliverAs: "followUp" fix.

Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.19.23...v0.19.24