backnotprop/plannotator v0.17.4

on GitHub

Follow @plannotator on X for updates

What's New in v0.17.4

v0.17.4 ships three PRs: a sidebar consolidation that folds the Obsidian vault browser into the Files tab, three new Kanagawa themes, and a Pi regression fix from @dmmulroy.

Vault Browser Merged into Files Tab

The sidebar previously had separate "Files" and "Vault" tabs when an Obsidian vault was configured. The two tabs had identical tree UI but parallel state, and switching between them broke the mental model of "files are files."

The Vault tab is gone. Vault directories now appear as collapsible sections inside the Files tab, beneath project directories, marked with an Obsidian icon in the section header. Annotation count badges still appear per-directory. Disabling the vault in Settings removes the section without affecting project file browsing.

Two server-side gaps accompany this change. The annotate server (both Bun and Pi) was missing the /api/obsidian/vaults, /api/reference/obsidian/files, and /api/reference/obsidian/doc endpoints — vault files were unreachable when opening linked docs via plannotator annotate ./. Those endpoints are now present on all three servers (plan, review, annotate).

The sticky header lane was also incorrectly suppressed whenever a linked doc was active. That gate has been removed. The sticky bar now follows scroll behavior consistently regardless of mode.

Net change is -334 lines: one Files tab handles all directory types uniformly.

#526

Kanagawa Themes

Three Kanagawa variants join the theme picker as dark-only themes, placed alphabetically after Gruvbox:

• Kanagawa Dragon — warmest variant, ash-black base (#181616) with muted teal accent
• Kanagawa Wave — the classic Kanagawa, cool blue-purple base (#1f1f28) with purple accent
• Kanagawa Bones — same base as Wave, earthier character, cyan-blue primary with brighter purple accent

Colors are mapped directly from the official Ghostty Kanagawa palette.

#524

Additional Changes

• Pi: planning tool stripped on fresh sessions. PR #446 refactored the Pi session_start handler to use applyPhaseConfig() but left the idle branch calling only restoreSavedState(), which no-ops when there's no saved state. On fresh sessions that had never entered planning mode, plannotator_submit_plan remained in the active tool set — a regression from #387. The idle branch now explicitly strips planning-only tools when there is no saved state to restore. (#525 by @dmmulroy)

Install / Update

macOS / Linux:

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

Windows:

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

Pin a specific version:

curl -fsSL https://plannotator.ai/install.sh | bash -s -- --version v0.17.4

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

Gemini CLI: The install script auto-detects ~/.gemini and configures hooks, policy, and slash commands. See apps/gemini/README.md for manual setup.

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

VS Code Extension: Install from the VS Code Marketplace. Tested with Claude Code running in VS Code's integrated terminal. Not currently compatible with Anthropic's official VS Code extension due to upstream hook bugs.

What's Changed

• feat(sidebar): merge vault browser into files tab + UX polish by @backnotprop in #526
• fix(pi): strip planning-only tools on fresh idle sessions by @dmmulroy in #525
• feat(themes): add Kanagawa Dragon, Wave, and Bones themes by @backnotprop in #524

Contributors

@dmmulroy tracked down and fixed a regression in the Pi tool-scoping logic he originally authored in #387 (#525). This is his fourth contribution to the project.

Full Changelog: v0.17.3...v0.17.4