sureagents

SureAgents

Interactive Plan Review for AI Agents
Annotate plans visually, share with team, automatically send feedback

---

What is SureAgents?

SureAgents is a visual plan review UI for AI coding agents like Claude Code, OpenCode, and Pi. Instead of reviewing agent plans in the terminal, you can:

• Annotate plans visually  select exact parts you want to change
• Mark for deletion  highlight code to remove
• Add comments  explain changes to the agent
• Suggest replacements  propose alternative code
• Share with team  collaborate on plan reviews
• Automatic feedback  agent receives your annotations automatically

Supported Agents

Agent	Plugin	Status
Claude Code	Skills	'
OpenCode	Plugin	'
Pi	Extension	'
Gemini CLI	Commands	'
Codex	App	'
Amp	Plugin	'
Droid	Plugin	'
Kiro CLI	Commands	'
VS Code	Extension	=��

Quick Start

Install for Claude Code

curl -fsSL https://sureagents.ai/install.sh | bash

This installs the skills that provide /sureagents-review, /sureagents-annotate, and /sureagents-last slash commands.

Install for OpenCode

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@sureagents/opencode@latest"]
}

Restart OpenCode. By default, the submit_plan tool is available to the plan agent.

Install for Pi

pi install npm:@sureagents/pi-extension

Or from source:

git clone https://github.com/suryansh1914/sureagents.git
cd sureagents
bun install
bun run build:pi
pi install ./apps/pi-extension

Features

Plan Mode

When an agent enters plan mode, SureAgents opens a visual UI in your browser where you can:

1. Read the plan  see what the agent intends to do
2. Select text  mark parts you want to modify
3. Choose action:
   • '� Comment  add feedback without changing code
   • =���� Delete  mark code for removal
   • =�� Replace  suggest alternative code
4. Submit  agent receives your annotations
5. Approve  run the plan as-is

Code Review Mode

After plan execution, review changed files in a split-view:

• Side-by-side diff  original vs. modified
• Syntax highlighting  with language support
• Annotation history  see past feedback
• Quick approve  accept all changes

Integrations

Obsidian

Auto-save approved plans to Obsidian:

1. Create a vault for plan reviews
2. Configure path in sureagents.json
3. Approved plans appear as markdown notes

GitHub PR

Create pull requests directly from annotations:

1. Annotate plan with feedback
2. Submit creates PR branch
3. Push opens PR on GitHub

Project Structure

sureagents/
%%% apps/                    # Agent integrations
%   %%% opencode-plugin/    # OpenCode plugin
%   %%% pi-extension/     # Pi extension
%   %%% vscode-extension/ # VS Code extension
%   %%% skills/            # Claude Code skills
%   %%% gemini/            # Gemini CLI commands
%   %%% hook/              # Plan review UI
%   %%% review/            # Code review UI
%   %%% portal/            # Hosting UI
%%% packages/              # Shared packages
%   %%% ai/                # AI provider SDKs
%   %%% server/            # Backend services
%   %%% ui/                # React components
%   %%% shared/            # Shared utilities
%%% scripts/               # Install scripts
%   %%% install.sh         # Unix installer
%   %%% install.ps1        # PowerShell installer
%   %%% install.cmd       # Windows cmd installer
%%% bin/                  # CLI entry point

Development

Prerequisites

• Bun  JavaScript runtime
• Node.js 24+ (for some apps)

Install Dependencies

bun install

Build

# Build all
bun run build

# Build specific app
bun run build:hook
bun run build:review
bun run build:pi

Test

bun test
bun run typecheck

Architecture

How It Works