Plannotator Openclaw

Name: Plannotator Openclaw
Rating: 3.5 (1 reviews)
Author: deanmoore1696-ops

By deanmoore1696-ops 👁 53 views ▲ 0 votes

OpenClaw plugin for Plannotator — interactive plan and code review for AI coding agents

GitHub

Install

openclaw plugins install --link

Configuration Example

{
  "plannotator": {
    "autoInstall": true,          // auto-install CLI if not found
    "browser": "Google Chrome",   // browser to open (macOS app name or executable path)
    "remoteMode": false,          // enable for SSH / devcontainer / WSL
    "port": 19432,                // fixed port for remote mode
    "shareUrl": "...",            // custom share portal URL for self-hosting
    "pasteUrl": "..."             // custom paste service URL
  }
}

README

# Plannotator Plugin for OpenClaw

Interactive plan and code review for AI coding agents — built as an OpenClaw plugin.

## What it does

Registers 4 tools in OpenClaw that pipe through the [Plannotator CLI](https://plannotator.ai):

| Tool | What it does |
|------|-------------|
| `plannotator_plan` | Submit your implementation plan for human review before execution |
| `plannotator_review` | Open code review UI for the current git diff or a GitHub PR |
| `plannotator_annotate` | Annotate any file, folder, URL, or markdown document |
| `plannotator_last` | Annotate the agent's most recent message |

When a tool is called, Plannotator opens in your browser. You annotate text visually — delete, replace, comment — then Approve or Request Changes. Structured feedback flows back to the agent.

## Installation

Requires plannotator CLI to be installed:

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

Then link the plugin:

```bash
openclaw plugins install --link ./path/to/plannotator-openclaw --dangerously-force-unsafe-install
openclaw gateway restart
```

> Note: `--dangerously-force-unsafe-install` is required because the plugin spawns a CLI subprocess (inherent to how Plannotator works).

## Configuration

In `plugins.entries.plannotator` (in your OpenClaw config):

```json
{
  "plannotator": {
    "autoInstall": true,          // auto-install CLI if not found
    "browser": "Google Chrome",   // browser to open (macOS app name or executable path)
    "remoteMode": false,          // enable for SSH / devcontainer / WSL
    "port": 19432,                // fixed port for remote mode
    "shareUrl": "...",            // custom share portal URL for self-hosting
    "pasteUrl": "..."             // custom paste service URL
  }
}
```

## How it works

1. **Tool called** → spawns `plannotator` CLI subprocess in background
2. **CLI starts local HTTP server** + opens your browser with the Plannotator UI
3. **You annotate** (delete, replace, comment) and click Approve or Request Changes
4. **Tool returns** structured feedback to the agent

Plans are encrypted end-to-end when shared via URL — zero-knowledge storage. Small plans are encoded entirely in the URL hash (no server storage).

## Files

```
plannotator-openclaw/
├── openclaw.plugin.json    # Plugin manifest
├── package.json            # npm package metadata
├── dist/
│   ├── index.js            # Plugin entry point
│   ├── plannotator-cli.js  # CLI detection / install / spawn
│   └── tools/
│       ├── plan-review.js
│       ├── code-review.js
│       ├── annotate.js
│       └── last-message.js
└── skills/
    └── plannotator/
        └── SKILL.md        # Agent skill documentation
```

## Publishing to ClawHub / npm

```bash
# Publish to npm
npm publish --access public

# Then install via OpenClaw
openclaw plugins install @your-scope/plannotator-plugin
```

## License

Apache-2.0 / MIT (same as Plannotator itself)

tools