canon

A browser-based annotation tool for Claude Code that lets you add
line-specific feedback to any file, with annotations flowing back
into your conversation as structured context.

AI Manifesto: Vibe-coding

This project is vibe-coded with AI. The associated code has undergone little to no review. It is recommended to fork this project if you would like to see it evolve.

Read the full AI Manifesto →

---

Install

Install the plugin from the claude-plugins marketplace:

claude plugin marketplace add deviantony/claude-plugins
claude plugin install canon@deviantony-plugins

Then in a Claude Code session, run /canon:setup to download the binary for your platform.

Supported platforms: Linux (x64, arm64), macOS (Apple Silicon), Windows (x64)

Usage

In a Claude Code session:

/canon:new

A browser window opens automatically at http://localhost:9847. Browse files, click lines to annotate, and submit to return feedback to Claude.

Update

To update Canon, update the marketplace and plugin:

claude plugin marketplace update deviantony-plugins
claude plugin update canon@deviantony-plugins

Then in a Claude Code session, run /canon:setup to update the binary.

Restart Claude Code after updating to ensure changes take effect.

Custom Install Location

To install the binary to a custom location instead of ~/.local/bin:

export CANON_BIN_DIR=/usr/local/bin

Then run /canon:setup.

Container/Remote

If running Claude Code in a container or over SSH:

export CANON_PORT=9000
export CANON_REMOTE=1
claude  # then run /canon:new and open the URL manually