mirror of https://github.com/backnotprop/plannotator.git synced 2026-09-14 14:17:26 +08:00

Files

T

History

Michael Ramos 9130d2d6a3 feat(review): open a review on a specific base and diff type (#1484 )

Adds two session-only flags to plannotator review, parsed in the shared
parser so every host inherits them together:

- --base <ref> opens the session against a caller-chosen compare target
  (branch, origin/<branch>, tag, SHA, HEAD~N), probed with git rev-parse
  --verify --end-of-options before the server starts so a typo'd ref is a
  startup error with near-match suggestions instead of a silently
  mislabelled merge-base->HEAD diff.
- --diff-type <id> opens the session in one of the nine flat git diff
  modes (REVIEW_OPEN_DIFF_TYPES, pinned against GIT_DIFF_TYPES).

The flags are a seed, never a setting: nothing writes config.json or any
review cookie, and the UI stays fully mutable. Validation is pure in
packages/shared/review-open-state.ts (provider matrix errors on
jj/GitButler/P4/workspace/PR mode, promote-with-notice when the saved
default is base-irrelevant, fatal explicit contradiction).

A flagged base rides explicitBase semantics: the new initialBaseExplicit
server option (both runtimes) seeds baseExplicitlyChosen, suppressing the
startup origin/* upgrade and canonicalization, and openStatePinned rides
/api/diff so the client neither offers the first-run setup dialog (its
one-time cookie is NOT consumed) nor runs the panel-pair self-heal for a
pinned session. The since-base dropdown label now renders from the live
active base, matching the adjacent base picker.

Coverage: Bun CLI, opencode-review bridge, OpenCode embedded plugin, and
the Pi extension (re-vendored; strict validation on the slash-command
path only, programmatic callers unchanged). Skills, command stubs, help
text, and docs updated across every host surface.

2026-09-09 21:35:05 -07:00

agents

feat(review): open a review on a specific base and diff type (#1484 )

2026-09-09 21:35:05 -07:00

skills

feat(review): open a review on a specific base and diff type (#1484 )

2026-09-09 21:35:05 -07:00

README.md

chore: remove the redundant /plannotator-status and /plannotator-archive commands (#873 )

2026-06-08 11:08:11 -07:00

README.md

Plannotator Kiro CLI Integration

Source package for Plannotator's Kiro CLI support. These files are consumed by the main installer (scripts/install.sh) — there is no separate Kiro installer. A Kiro user installs with the same one-liner as everyone else.

skills/ — Kiro-specific skill packages (plannotator-review, plannotator-annotate), each baking PLANNOTATOR_ORIGIN=kiro-cli into its command.
agents/plannotator.json — an example Kiro custom agent that exposes the Plannotator skills via skill:// resources and a plannotator-scoped shell tool.

How it installs

scripts/install.sh auto-detects Kiro (if ~/.kiro exists or kiro-cli is on PATH — the same convention used for Codex and Gemini) and installs:

the 2 Kiro-specific skills above → ~/.kiro/skills
the 2 shared skills plannotator-setup-goal and plannotator-visual-explainer (pulled from apps/skills/extra/, not duplicated here) → ~/.kiro/skills
the example agent agents/plannotator.json → ~/.kiro/agents/plannotator.json (an existing file is never overwritten)

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

Use the Plannotator agent

The installed agent wires all four skills via skill:// resources and, in its prompt, documents which skill to use for which task (review, annotate, setup-goal, visual-explainer). Launch it:

kiro-cli chat --agent plannotator

Or add the same skill://~/.kiro/skills/plannotator-*/SKILL.md resources to one of your own agents.

Schema note

agents/plannotator.json is a conservative example. If Kiro changes its custom-agent schema, adapt the installed copy at ~/.kiro/agents/plannotator.json.

README.md

Plannotator Kiro CLI Integration

Contents

How it installs

Use the Plannotator agent

Schema note