Files
Michael Ramos b19505efd3 chore: remove the redundant /plannotator-status and /plannotator-archive commands (#873)
Two agent command-surface cleanups. Both remove only the command entry points; all underlying infrastructure stays.

1. /plannotator-status (Pi): removed — it echoed phase/plan-file/progress on
   demand, but that state is already shown ambiently (status bar + live
   checklist widget). The phase/checklist state machine is untouched.

2. /plannotator-archive (all agents): removed the command/skill entry points
   across every surface — Claude/Codex/Kiro skills, Pi, OpenCode (handler +
   dispatch + cli-bridge + embedded + stub), Droid, the Kiro agent prompt, all
   three installers, docs, marketing, and the CI deprecated-command guard. The
   installers also gained a stale-skill cleanup so upgraders drop a previously
   installed plannotator-archive skill.

Kept (infrastructure) — archive browsing stays available in-review via the
sidebar: the `plannotator archive` CLI subcommand (apps/hook/server), the
mode:"archive" server path + /api/archive endpoints, ArchiveBrowser/useArchive,
the sidebar Archive tab, sessions.ts "archive" mode, and ~/.plannotator/plans
storage.

Verified: bun test scripts/install.test.ts → 72 pass; pi-extension typecheck +
build:opencode pass; repo-wide residual scan clean; KEEP-set integrity
confirmed; one orphaned import (opencode commands.ts) caught in self-review and
removed.
2026-06-08 11:08:11 -07:00

2.0 KiB

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.

Contents

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