backnotprop/plannotator v0.15.2

on GitHub

Follow @plannotator on X for updates

What's New in v0.15.2

v0.15.2 introduces Compound Planning, adds folder annotation, the /plannotator-archive slash command, and fixes Pi's plan tool scoping. 5 PRs, 1 from an external contributor.

Compound Planning: Learn From Your Own Planning Patterns

Skill: /plannotator-compound

Demo: https://x.com/plannotator/status/2036607307979886984

Compound Planning is a new skill that surfaces your own insights: what kinds of plans get denied, what feedback you give most often, how your planning has evolved over time. The goal is to consistently refine and optimize the planning that works best for you, and eventually create an automated feedback loop between your review patterns and your agent's planning behavior.

This is the first step toward a system where your agent gets better at planning for you specifically, based on your actual history of approvals, denials, and annotations.

The platform install scripts now install Plannotator's skill (just 1 for now) automatically alongside the binary.

• #390

Annotate Entire Folders

plannotator annotate now accepts a directory path. Instead of opening a single file, it starts the annotate server with the sidebar Files tab pre-loaded, showing all markdown files in that directory. The viewer starts empty with a prompt to select a file. This lets you review and annotate an entire folder of docs, specs, or notes in one session.

Works in both the Bun hook and the Pi extension.

• #389

/plannotator-archive Slash Command

The plan archive browser was previously only accessible via the CLI (plannotator archive) and the Pi extension. This release adds /plannotator-archive as a slash command for Claude Code and OpenCode, so all three runtimes can browse saved plan decisions the same way. The archive is read-only: it opens the browser, you browse your plans, and it closes when you're done.

• #388

Additional Changes

• Pi plan tool scoping. The Pi extension's plan submission tool was renamed to plannotator_submit_plan and is now hidden outside of planning mode. Previously, the tool was visible globally, which could confuse the agent. The fix also properly restores the pre-plan tool set when planning ends (#387 by @dmmulroy, closing #386)
• Pi AI backbone bundling. The @plannotator/ai package was missing from published Pi packages because it's a private workspace dependency. AI files are now copied into generated/ai/ at build time, matching the existing pattern for shared utilities. Pi users installing from npm now get AI features in code review.

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

What's Changed

• fix: Pi plan tool scoping by @dmmulroy in #387
• feat: add /plannotator-archive slash command by @backnotprop in #388
• feat: support folder annotation via plannotator annotate <folder/> by @backnotprop in #389
• feat: install skills via git sparse-checkout in platform install scripts by @backnotprop in #390
• fix(pi): bundle AI backbone into generated/ for published package by @backnotprop in 1175ef6

Community

@dmmulroy authored the Pi plan tool scoping fix (#387), which he also reported in #386. This is his third contribution to the project.

Full Changelog: v0.15.0...v0.15.2