Plannotator

tip

5,561 GitHub stars — Annotate and review coding agent plans and code diffs visually. Share with your team and send feedback to agents with one click.

Overview

Plannotator bridges the gap between AI agent output and human review. It captures plans and code diffs produced by OpenCode, renders them in a visual annotation interface, and allows team members to review, comment, and send feedback back to the agent — all without leaving the review workflow.

When to Use

Scenario	Benefit
Code review	Review agent-generated diffs before committing
Plan approval	Get stakeholder sign-off on implementation plans
Team collaboration	Share agent sessions with remote team members
Audit trails	Keep a permanent record of agent-generated changes
Feedback loops	Send structured feedback back to the agent

How It Works

1. Agent produces output — OpenCode generates a plan or code diff.
2. Plannotator captures it — The plugin intercepts the output and creates an annotated view.
3. Team reviews — Collaborators add comments, highlight sections, and approve or request changes.
4. Feedback is sent back — Annotations are compiled into structured feedback.
5. Agent incorporates feedback — The agent receives the feedback and adjusts its approach.

Installation

npm

{
  "plugin": ["@plannotator/opencode"]
}

Local

git clone https://github.com/backnotprop/plannotator.git

Then add to config:

{
  "plugin": ["./path/to/plannotator"]
}

Configuration

Basic Setup

{
  "plugin": ["@plannotator/opencode"],
  "permission": {
    "webfetch": "allow"
  }
}

Sharing Options

Plannotator supports both public and private sharing:

{
  "plannotator": {
    "sharing": "private",
    "expire_after_days": 30
  }
}

Usage

Share a Plan for Review

After the agent generates a plan:

/share

Plannotator captures the plan and creates a shareable link.

Annotate a Diff

When the agent produces code changes, team members can:

• Highlight specific lines or blocks.
• Add inline comments with suggestions.
• Categorize feedback (blocking vs. non-blocking).
• Approve or request revisions.

Send Feedback to Agent

Once review is complete:

Apply the feedback from the Plannotator review on my last plan.

The agent incorporates the annotated feedback into its next iteration.

Best Practices

Review Before Commit

• Always review agent-generated diffs through Plannotator before merging.
• Use the annotation layer to catch context-dependent issues the agent may miss.

Structured Feedback

• Categorize feedback by severity: critical, important, nice-to-have.
• Provide specific suggestions rather than vague comments.
• Reference specific lines or sections in annotations.

Team Workflow Integration

• Integrate Plannotator with your existing review process (PRs, change requests).
• Use private sharing for internal reviews and public for cross-team collaboration.

GitHub

• Repo: backnotprop/plannotator
• Topics: plan-review, annotation, sharing, collaboration
• Category: Agent Workflow / Orchestration