Plannotator provides a structured review UI where the user can leave inline annotations on specific files and lines. Use it to get precise, actionable feedback.
Run the following command to start a review session. Set the Bash tool timeout to 1800000ms (30 minutes) so the user has enough time to review and annotate.
plannotator review
Plannotator starts a local HTTP server. If the execution environment sandboxes localhost socket creation, run the command using its narrowest available permission-escalation mechanism. Otherwise, run it normally.
If Plannotator reports that its entire port range is exhausted in a sandboxed environment, treat that as a possible socket-permission failure rather than immediately changing ports; retry once with permission to bind a localhost socket.
Reviewing Feedback
For each annotation from the user:
- Summarize the feedback in one line
- Evaluate whether the suggestion is valid — push back if it would introduce a bug, conflict with project conventions, or reduce code quality
- Act — apply the fix or explain why you disagree
If no changes were requested, acknowledge this and move on.