Skip to content

VS Code extension that intercepts Plannotator browser opens and displays plan reviews inside VS Code tabs instead of an external browser.

License

Notifications You must be signed in to change notification settings

7tg/plannotator-vscode

Repository files navigation

Plannotator for VS Code

VS Code Marketplace CI VS Code License: MIT

Opens Plannotator plan reviews inside VS Code tabs instead of an external browser.

Features

  • Automatically intercepts Plannotator browser opens and displays them in a VS Code panel
  • Persists your Plannotator settings (identity, permissions, editor preferences) across sessions
  • Auto-closes the panel when you approve or send feedback on a plan
  • Works with Claude Code running in VS Code's integrated terminal
  • Configurable via VS Code settings
  • Manual URL opening via command palette

How It Works

When Plannotator opens a browser to show a plan review, this extension intercepts the request and opens it in a VS Code panel instead:

  1. The extension injects a PLANNOTATOR_BROWSER environment variable into integrated terminals
  2. When Plannotator opens a URL, the bundled router script sends it to the extension via a local HTTP server
  3. The extension opens the URL in a custom WebviewPanel with an embedded iframe
  4. A local reverse proxy handles cookie persistence (VS Code webview iframes don't support cookies natively) — settings are stored in VS Code's global state and restored transparently

Requirements

Configuration

Setting Default Description
plannotatorWebview.injectBrowser true Inject PLANNOTATOR_BROWSER env var into integrated terminals

Commands

  • Plannotator: Open URL — Manually open a Plannotator URL in a panel

Troubleshooting

URL opens in external browser instead of VS Code

  • Ensure plannotatorWebview.injectBrowser is enabled
  • Open a new terminal after installing the extension (existing terminals won't have the env var)

Panel shows a blank page

  • Check if Plannotator's server is still running
  • Some network configurations may block localhost access from the webview

License

MIT

About

VS Code extension that intercepts Plannotator browser opens and displays plan reviews inside VS Code tabs instead of an external browser.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published