Skip to main content
When a coding agent resubmits a plan, Plannotator can show the lines it added and removed since the previous version. Open the diff badge to review the changed sections instead of rereading the entire plan. Originally published February 22, 2026, by backnotprop. Last reviewed July 18, 2026. Maintained by the Plannotator project. Plan Diff came from community requests #138 and #111. The original feature demo shows the first version of the interaction.

​
Open the plan diff

Plannotator saves each arriving plan before it opens the review UI. When another version of the same plan arrives, a +N/-M badge appears below the document card. Select the badge to switch between the normal plan and its diff. The automatic comparison uses the immediately previous version. Open the Version Browser in the sidebar to choose an older base version.

​
Choose a diff view

  • Rendered shows the plan as formatted content. Added blocks use green, removed blocks use red with strikethrough, and modified blocks use yellow.
  • Raw shows a Git-style Markdown diff with + and - lines.
Both views come from the same line-level diff. Plannotator groups consecutive removals and additions into modified blocks so related changes stay together. You can annotate an added, removed, or modified block. The returned feedback labels the comment as diff content so the agent knows you were responding to a revision.

​
How plan versions are grouped

Plannotator derives a plan slug from the first Markdown heading, the date, and the current project. Plans with the same heading on the same day in the same project are treated as iterations of one plan. Identical resubmissions are deduplicated. Versions are stored under the Plannotator data directory, normally:
This history is separate from the optional decision snapshots stored under ~/.plannotator/plans/. The heading-and-date grouping can misclassify unusual cases. If two unrelated plans use the same first heading on the same day, inspect the selected base in the Version Browser before relying on the diff.

​
Use the diff in a review loop

  1. Review the first plan and select Send Feedback.
  2. Let the agent revise and resubmit it.
  3. Open the +N/-M badge.
  4. Check whether the revision addresses your feedback and whether it introduces a new issue.
  5. Approve the current plan or send another round of feedback.
Plan Diff compares stored versions on your computer. Formal authorization, synchronization between people, and cross-plan comparison are outside this local feature.

Review an agent plan

Follow the complete plan review, feedback, revision, and approval loop.
Last modified on July 19, 2026