docs: add /plannotator-last to docs and install scripts (#327)

* docs: add /plannotator-last to READMEs and marketing docs

* feat: add /plannotator-last to install scripts


* fix: sync review command wording in install scripts with plugin

The plugin's plannotator-review.md was updated in #293 to handle
LGTM approvals but the install scripts still had the old wording.

Author: backnotprop

README.md

@@ -36,6 +36,7 @@ Interactive Plan & Code Review for AI Coding Agents. Mark up and refine your pla
 <tr><td><strong>Plan Diff</strong></td><td>Automatic</td><td>See what changed when the agent revises a plan</td></tr>
 <tr><td><strong>Code Review</strong></td><td><code>/plannotator-review</code></td><td>Review git diffs with line-level annotations</td></tr>
 <tr><td><strong>Annotate Any File</strong></td><td><code>/plannotator-annotate</code></td><td>Annotate any markdown file and send feedback to your agent</td></tr>
+<tr><td><strong>Annotate Last Message</strong></td><td><code>/plannotator-last</code></td><td>Annotate the agent's last response and send structured feedback</td></tr>
 </table>
 
 #### Sharing Plans
@@ -143,6 +144,7 @@ irm https://plannotator.ai/install.ps1 | iex
 ```
 !plannotator review           # Code review for current changes
 !plannotator annotate file.md # Annotate a markdown file
+!plannotator last             # Annotate the last agent message
 ```
 
 Plan mode is not yet supported.

apps/codex/README.md

@@ -36,6 +36,16 @@ Run `!plannotator annotate` to annotate any markdown file:
 !plannotator annotate path/to/file.md
 ```
 
+### Annotate Last Message
+
+Run `!plannotator last` to annotate the agent's most recent response:
+
+```
+!plannotator last
+```
+
+The message opens in the annotation UI where you can highlight text, add comments, and send structured feedback back to the agent.
+
 ## Environment Variables
 
 | Variable | Description |

apps/hook/README.md

@@ -102,6 +102,16 @@ Host your-server
     LocalForward 9999 localhost:9999
 ```
 
+## Slash Commands
+
+The plugin registers three slash commands:
+
+| Command | Description |
+|---------|-------------|
+| `/plannotator-review` | Open code review UI for uncommitted changes |
+| `/plannotator-annotate <file.md>` | Annotate any markdown file |
+| `/plannotator-last` | Annotate the agent's last message |
+
 ## Obsidian Integration
 
 Approved plans can be automatically saved to your Obsidian vault.

apps/marketing/src/content/docs/commands/annotate-last.md

@@ -0,0 +1,82 @@
+---
+title: "Annotate Last"
+description: "The /plannotator-last slash command for annotating the agent's most recent message."
+sidebar:
+  order: 13
+section: "Commands"
+---
+
+The `/plannotator-last` command opens the agent's most recent response in the annotation UI, letting you highlight text, add comments, and send structured feedback back.
+
+## Usage
+
+### Claude Code
+
+```
+/plannotator-last
+```
+
+### OpenCode
+
+```
+/plannotator-last
+```
+
+### Pi
+
+```
+/plannotator-last
+```
+
+### Codex
+
+```
+!plannotator last
+```
+
+## How it works
+
+```
+User runs /plannotator-last
+        ↓
+Last assistant message extracted from session
+        ↓
+Annotate server starts (random port)
+        ↓
+Browser opens, loads annotation UI
+        ↓
+/api/plan returns { plan: message, mode: "annotate-last" }
+        ↓
+User annotates → Send Annotations
+        ↓
+Feedback sent to agent
+```
+
+## Session log parsing
+
+Each harness reads the last assistant message differently:
+
+| Harness | Source | Method |
+|---------|--------|--------|
+| **Claude Code** | `~/.claude/projects/{slug}/*.jsonl` | Parses JSONL session logs, finds last assistant text blocks |
+| **OpenCode** | SDK | `client.session.messages()` API |
+| **Pi** | SDK | `ctx.sessionManager.getEntries()` API |
+| **Codex** | `~/.codex/sessions/` rollout files | Parses JSONL by `CODEX_THREAD_ID` env var |
+
+For Claude Code, the parser handles streamed chunks (multiple JSONL lines sharing the same `message.id`), filters out system-generated user messages, and skips noise entries. If the most recent session log has no assistant messages, it tries earlier logs sorted by modification time.
+
+## Annotate-last mode differences
+
+The annotation UI in `annotate-last` mode works the same as `/plannotator-annotate`, with minor copy changes:
+
+- Copy button shows "Copy message" instead of "Copy plan"
+- Completion screen says "annotations on the message"
+- Feedback export is titled "Message Feedback" instead of "Plan Feedback"
+
+## Server API
+
+The annotate-last mode reuses the same annotate server endpoints. See the [annotate docs](/docs/commands/annotate/#server-api).
+
+## Environment variables
+
+Same as plan review. See the [environment variables reference](/docs/reference/environment-variables/).

apps/marketing/src/content/docs/getting-started/quickstart.md

@@ -55,3 +55,11 @@ Your annotations are exported as structured feedback that Claude can act on dire
 ## 5. Claude continues
 
 After approval, Claude implements the plan. After feedback, Claude revises the plan and presents it again for review. When the revised plan arrives, a diff badge shows what changed — click it to toggle between normal and diff view. The cycle continues until you approve.
+
+## Other commands
+
+Beyond plan review, Plannotator provides slash commands you can use anytime during a session:
+
+- **`/plannotator-review`** — Review uncommitted code changes. See [Code Review](/docs/commands/code-review/).
+- **`/plannotator-annotate <file.md>`** — Annotate any markdown file. See [Annotate](/docs/commands/annotate/).
+- **`/plannotator-last`** — Annotate the agent's last message. See [Annotate Last](/docs/commands/annotate-last/).

apps/marketing/src/content/docs/guides/claude-code.md

@@ -69,7 +69,7 @@ If you want to approve with minor notes, use "Send Feedback" — Claude will see
 
 ## Slash commands
 
-The plugin registers two slash commands that work inside your Claude Code session:
+The plugin registers three slash commands that work inside your Claude Code session:
 
 ### `/plannotator-review`
 
@@ -79,6 +79,10 @@ Opens a code review UI for your uncommitted `git diff`. See the [code review doc
 
 Opens any markdown file in the annotation UI. See the [annotate docs](/docs/commands/annotate/) for details.
 
+### `/plannotator-last`
+
+Annotates the agent's most recent message. See the [annotate last docs](/docs/commands/annotate-last/) for details.
+
 ## Plugin installation
 
 The plugin is installed from the marketplace:

apps/marketing/src/content/docs/guides/opencode.md

@@ -40,7 +40,7 @@ If the configured agent isn't found in the current OpenCode session, Plannotator
 
 ## Slash commands
 
-The plugin registers two slash commands:
+The plugin registers three slash commands:
 
 ### `/plannotator-review`
 
@@ -50,6 +50,10 @@ Opens a code review UI for uncommitted changes. Requires the CLI to be installed
 
 Opens a markdown file in the annotation UI. Also requires the CLI.
 
+### `/plannotator-last`
+
+Annotates the agent's most recent message. See the [annotate last docs](/docs/commands/annotate-last/) for details.
+
 Install the CLI for slash command support:
 
 ```bash

apps/opencode-plugin/README.md

@@ -30,7 +30,7 @@ Add to your `opencode.json`:
 
 Restart OpenCode. The `submit_plan` tool is now available.
 
-> **Slash commands:** Run the install script to get `/plannotator-review`:
+> **Slash commands:** Run the install script to get `/plannotator-review`, `/plannotator-annotate`, and `/plannotator-last`:
 > ```bash
 > curl -fsSL https://plannotator.ai/install.sh | bash
 > ```
@@ -49,6 +49,7 @@ Restart OpenCode. The `submit_plan` tool is now available.
 - **Runs locally**: No network requests. Plans never leave your machine.
 - **Private sharing**: Plans and annotations compress into the URL itself—share a link, no accounts or backend required
 - **Plan Diff**: See what changed when the agent revises a plan after feedback
+- **Annotate last message**: Run `/plannotator-last` to annotate the agent's most recent response
 - **Obsidian integration**: Auto-save approved plans to your vault with frontmatter and tags
 
 ## Environment Variables

apps/pi-extension/README.md

@@ -71,6 +71,10 @@ Run `/plannotator-review` to open your current git changes in the code review UI
 
 Run `/plannotator-annotate <file.md>` to open any markdown file in the annotation UI. Useful for reviewing documentation or design specs with the agent.
 
+### Annotate last message
+
+Run `/plannotator-last` to annotate the agent's most recent response. The message opens in the annotation UI where you can highlight text, add comments, and send structured feedback back to the agent.
+
 ### Progress tracking
 
 During execution, the agent marks completed steps with `[DONE:n]` markers. Progress is shown in the status line and as a checklist widget in the terminal.
@@ -84,6 +88,7 @@ During execution, the agent marks completed steps with `[DONE:n]` markers. Progr
 | `/plannotator-status` | Show current phase, plan file, and progress |
 | `/plannotator-review` | Open code review UI for current changes |
 | `/plannotator-annotate <file>` | Open markdown file in annotation UI |
+| `/plannotator-last` | Annotate the last assistant message |
 
 ## Flags
 

scripts/install.cmd

@@ -185,7 +185,7 @@ echo !`plannotator review`
 echo.
 echo ## Your task
 echo.
-echo Address the code review feedback above. The user has reviewed your changes in the Plannotator UI and provided specific annotations and comments.
+echo If the review above contains feedback or annotations, address them. If no changes were requested, acknowledge and continue.
 ) > "!CLAUDE_COMMANDS_DIR!\plannotator-review.md"
 
 echo Installed /plannotator-review command to !CLAUDE_COMMANDS_DIR!\plannotator-review.md
@@ -207,6 +207,23 @@ echo Address the annotation feedback above. The user has reviewed the markdown f
 
 echo Installed /plannotator-annotate command to !CLAUDE_COMMANDS_DIR!\plannotator-annotate.md
 
+(
+echo ---
+echo description: Annotate the last rendered assistant message
+echo allowed-tools: Bash^(plannotator:*^)
+echo ---
+echo.
+echo ## Message Annotations
+echo.
+echo !`plannotator annotate-last`
+echo.
+echo ## Your task
+echo.
+echo Address the annotation feedback above. The user has reviewed your last message and provided specific annotations and comments.
+) > "!CLAUDE_COMMANDS_DIR!\plannotator-last.md"
+
+echo Installed /plannotator-last command to !CLAUDE_COMMANDS_DIR!\plannotator-last.md
+
 echo.
 echo Test the install:
 echo   echo {"tool_input":{"plan":"# Test Plan\\n\\nHello world"}} ^| plannotator
@@ -215,7 +232,7 @@ echo Then install the Claude Code plugin:
 echo   /plugin marketplace add backnotprop/plannotator
 echo   /plugin install plannotator@plannotator
 echo.
-echo The /plannotator-review and /plannotator-annotate commands are ready to use!
+echo The /plannotator-review, /plannotator-annotate, and /plannotator-last commands are ready to use!
 
 REM Warn if plannotator is configured in both settings.json hooks AND the plugin (causes double execution)
 REM Only warn when the plugin is installed — manual-only users won't have overlap