Repository navigation
docs: 0.28.0 — Claude Code mod on by default, Ask this session, correct plugin update steps - #1691
Merged
Merged
Conversation
…ct plugin update steps Claude Code docs describe the Plannotator mod (on by default on 2.1.287+, non-blocking plan review/review/annotate/last, revisions in the same tab, two-hop approval, the plannotator tool, opt-out, the leave-plan-mode limit). Env and config references add PLANNOTATOR_CLAUDE_MOD, PLANNOTATOR_MOD_DEBUG and claudeCodeMod. Ask AI docs add Ask this session. Plugin update steps: /plugin marketplace update alone does not update an installed plugin. Docs, READMEs and the install.sh/ps1/cmd closing banner now give claude plugin marketplace update plannotator + claude plugin update plannotator@plannotator + restart (verified against Claude Code 2.1.289; the /plugin slash command has no update subcommand, so the in-session path is /plugin > Installed > plannotator > Update now). Pi: pi update --extensions, Esc no longer cancels a plan review, Ask this session. OpenCode: the installer clears the OpenCode 2 plugin cache too.
…eload-plugins; plan-mode command takes no path
backnotprop
force-pushed
the
docs/release-028
branch
from
October 4, 2026 23:20
8f105f1 to
cbe58ff
Compare
1 task
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only PR for the 0.28.0 release. Merge after #1686 (Claude Code mod on by default). This branch is
main+ #1686 merged + one docs commit, so until #1686 lands the diff also shows #1686's commits. Only the last commit (docs: 0.28.0 …) belongs to this PR.What changes
guides/claude-code.md,commands/plan-review.md,getting-started/quickstart.md,getting-started/installation.md,apps/hook/README.md,README.md). The mod is on by default on Claude Code 2.1.287+ in the interactive terminal. Plan review, code review, annotate and last don't make Claude wait. The decision arrives later as a message. A revised plan updates the same tab. After approval, Claude calls ExitPlanMode once more and runs the exact approved text. Claude can open Plannotator with theplannotatortool. Older Claude Code,-p/SDK and Windows keep the classic flow. Opt-out:PLANNOTATOR_CLAUDE_MOD=0/{ "claudeCodeMod": false }. The pages also state the known limit: if you leave plan mode before approving, Claude can start editing. The "Long reviews" Bash timeout note now says it applies only without the mod.PLANNOTATOR_CLAUDE_MOD,PLANNOTATOR_MOD_DEBUGand theclaudeCodeModkey.guides/ai-features.md,commands/code-review.md, Pi and OpenCode READMEs,guides/opencode.md). When Plannotator is opened from Claude Code (mod), Pi or OpenCode 2, the session is the only Ask AI option. Covers busy handling (Ask when it finishes / Interrupt and ask now), the OpenCode 2 plan-review quick answer, when you still pick a provider, and that Review Agents / Code Tour / Guided Review keep their own models.install.sh/install.ps1/install.cmdclosing banner; echo text only)./plugin marketplace updatealone does not update an installed plugin. Verified against Claude Code 2.1.289:claude plugin marketplace update plannotator, thenclaude plugin update plannotator@plannotator, then restart (or/reload-plugins)./pluginslash command has noupdatesubcommand:/plugin update …just opens the menu. Inside Claude Code the path is/plugin marketplace update plannotator, then/plugin→ Installed → plannotator → Update now.pi update --extensions(a plainpi updateupdates only Pi; checked againstpi update --help, Pi 0.85.1). Also: Esc no longer cancels a plan review (leave plan mode to abandon it), and Ask this session.opencode2 plugin updatebecause I could not confirm the command exists.Checks
bun test scripts/install.test.ts(plus the other tests that read README/docs paths): pass. No test pins the old banner lines.bun run build:marketing: builds, and the new anchors (#the-plannotator-mod,#turning-the-mod-off,#ask-this-session,#updating) resolve.