Package Exports

@plannotator/opencode
@plannotator/opencode/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@plannotator/opencode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@plannotator/opencode

Annotate plans. Not in the terminal.

Interactive Plan Review for OpenCode. Select the exact parts of the plan you want to change—mark for deletion, add a comment, or suggest a replacement. Feedback flows back to your agent automatically.

Obsidian users can auto-save approved plans to Obsidian as well. See details

Watch Demo

Install

Add to your opencode.json:

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

Restart OpenCode. The submit_plan tool is now available.

Existing users: If you're stuck on an old version, clear both caches and restart:
rm -rf ~/.cache/opencode/node_modules/@plannotator ~/.bun/install/cache/@plannotator

How It Works

Agent calls submit_plan → Plannotator opens in your browser
Select text → annotate (delete, replace, comment)
Approve → Agent proceeds with implementation
Request changes → Annotations sent back as structured feedback

Features

Visual annotations: Select text, choose an action, see feedback in the sidebar
Runs locally: No network requests. Plans never leave your machine.
Private sharing: Plans and annotations compress into the URL itself—share a link, no accounts or backend required
Obsidian integration: Auto-save approved plans to your vault with frontmatter and tags

Devcontainer / Docker

Works in containerized environments. Set two env vars and forward the port:

{
  "containerEnv": {
    "PLANNOTATOR_REMOTE": "1",
    "PLANNOTATOR_PORT": "9999"
  },
  "forwardPorts": [9999]
}

Then open http://localhost:9999 when submit_plan is called.

See devcontainer.md for full setup details.

Obsidian Integration

Save approved plans directly to your Obsidian vault.

Open Settings in Plannotator UI
Enable "Obsidian Integration" and select your vault
Approved plans save automatically with:
- Human-readable filenames: Title - Jan 2, 2026 2-30pm.md
- YAML frontmatter (created, source, tags)
- Auto-extracted tags from plan title and code languages
- Backlink to [[Plannotator Plans]] for graph view

JSPM