backnotprop/plannotator v0.16.3 on GitHub

Follow @plannotator on X for updates

Missed recent releases?

Release	Highlights
v0.16.2	Draggable comment popovers, cross-file annotation visibility, custom diff fonts, OpenCode verbose log fix
v0.16.1	SSE stream idle timeout fix for external annotations API
v0.16.0	GitHub Copilot CLI, external annotations API, bot callback URLs, interactive checkboxes, print support, diff display options
v0.15.5	Custom display names, GitHub viewed file sync, expand/collapse all in file tree, search performance, WSL fix
v0.15.2	Compound Planning skill, folder annotation, `/plannotator-archive` slash command, skill installation via platform installers
v0.15.0	Live AI chat in code review, plan archive browser, folder file viewer, resizable split pane, Pi full feature parity
v0.14.5	GitLab merge request review, login page image fix, Windows install path fix
v0.14.4	GitHub review submission, repo identifier in tab title, nested code fence parser fix, Pi paste URL wiring
v0.14.3	PR context panel, diff search in code review, OpenCode permission normalization, landing page redesign
v0.14.2	OpenCode plan mode prompt replacement, Windows non-ASCII path fix, Pi link fix
v0.14.1	Single submit_plan with auto-detect, viewed-file draft persistence, Bear nested tag fix

What's New in v0.16.3

v0.16.3 brings Pi phase configuration, a CLI help message, and two code review fixes that address missing untracked files when the agent runs from a subdirectory and scroll position persisting across file switches. 4 PRs, 3 from external contributors, 2 first-timers.

Pi Phase Configuration

Pi users can now customize Plannotator's phase behavior (model, tools, prompt) through configuration files. Phase settings can be defined in a project-level plannotator.json, in .pi/agent, or globally in ~/.pi/agent. This lets you tailor Plannotator's planning workflow per project or globally without modifying the extension itself.

Authored by @stk-code in #446

CLI Help and No-Arg Usage

Running plannotator directly in a terminal with no arguments previously hung waiting for stdin, giving no indication of what it expected. Now it prints a short clarification message and exits. plannotator --help shows a top-level usage message listing available subcommands. The existing hook contract (stdin-fed JSON from Claude Code) is unchanged.

Authored by @foxytanuki in #448, closing #447

Untracked File Discovery Fix

When an agent's working directory was a subdirectory of the repo (e.g., after cd packages/foo/), git ls-files --others would only find untracked files within that subtree, silently dropping files elsewhere in the repo. Paths in the diff output were also CWD-relative instead of root-relative, causing mismatches with tracked file diffs. The fix resolves the repo root and uses it as the CWD for both git ls-files and git diff --no-index. A regression test verifies the fix from a subdirectory.

Authored by @blimmer in #450, closing #449

Additional Changes

Review scroll reset. The code review diff viewport now resets to the top-left when switching files, instead of preserving the scroll position from the previous file (#452, closing #451 reported by @UberMouse)

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

Copilot CLI:

/plugin marketplace add backnotprop/plannotator
/plugin install plannotator-copilot@plannotator

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

What's Changed

feat(pi): support phase config files by @stk-code in #446
cli: clarify no-arg usage and add top-level help by @foxytanuki in #448
fix(review): resolve repo root for untracked file discovery by @blimmer in #450
fix(review): reset scroll on file switch by @backnotprop in #452

New Contributors

@stk-code made their first contribution in #446
@blimmer made their first contribution in #450

Contributors

@stk-code contributed Pi phase configuration support (#446), bringing per-project customization to the Pi extension.

@foxytanuki returned for a second contribution with the CLI help message (#448), after the SSE timeout fix in v0.16.1.

@blimmer identified and fixed the untracked file discovery bug (#449, #450), including a regression test. First contribution.

@UberMouse reported the scroll position issue in code review (#451).

Full Changelog: v0.16.2...v0.16.3