Repository navigation
Releases
v0.18.0 — Select page areas
- Choose Select area in the browser panel, then drag a rectangle around the part of the page you want to annotate. Feedback includes coordinates, visible text and element selectors when available. No screenshot is captured.
- Unsent areas keep their numbered outlines when you scroll, reload or return to the page. Select a marker to move or resize it; its evidence updates without changing its note number.
- Browser protocol 10 requires matching companion files. Reload the Chrome extension and restart OpenCode after updating.
Install or update
opencode plugin add @nxxxsooo/opencode-annotate@latest
# Already installed:
opencode plugin update @nxxxsooo/opencode-annotate@latestv0.17.1 — picking inside modal drawers
- Keep annotation highlights, numbered markers and reveal outlines visible over modal drawers, including nested dialogs and same-origin frames. Page clicks still pass through the overlay.
- Match Herdr 0.9.5 pane placements. The launcher defaults to
overlayand also supportssplit,tabandzoomed. Replace oldpopupplacement and removepopup_width/popup_heightsettings. - Saved notes and browser protocol 8 are unchanged. Reload the Chrome extension and refresh pages already using annotation tools after updating.
Install or update
opencode plugin add @nxxxsooo/opencode-annotate@latest
# Already installed:
opencode plugin update @nxxxsooo/opencode-annotate@latestv0.17.0 — clear the round
- Clear in the notes header removes every unsent note in the round; each page
group also has its own Clear. One Undo restores the whole removed batch. - Keep delivered history, Restore last round and page-local drafts. A pending
retry batch is dropped only after inline confirmation when clearing the round. - Browser protocol 8 requires matching companion files: reload the Chrome extension
and restart OpenCode after updating.
Install or update
opencode plugin update @nxxxsooo/opencode-annotate@latestReload the Annotate Chrome extension and restart OpenCode after updating.
v0.16.1 — picking inside frames
- Fix picking and text selection inside same-origin iframes, legacy framesets and
nested frames. Reveal and page markers find notes in frames after a reload. - Record each note's frame in a
Frame:line in delivered Markdown. Cross-origin
frames show a clear message instead of silently failing to pick. - Browser protocol 7 requires matching companion files: reload the Chrome extension
and restart OpenCode after updating.
Install or update
opencode plugin update @nxxxsooo/opencode-annotate@latestReload the Annotate Chrome extension and restart OpenCode after updating.
v0.16.0 — /ref moves to Another
- Breaking: remove
/ref,/ref --all,/ref --tuiand the agent session
search/read tools. Conversation references now belong to Another; Another 0.28.0
ships a cross-agent/ref; install it and runanother setup. - Existing
opencode.json(c)plugin entries keep working, including option sync.
Remove anyannotate_session_*permission rules. Reply, document and webpage
annotation remain in Annotate.
Install or update
opencode plugin update @nxxxsooo/opencode-annotate@latestRestart OpenCode after updating.
v0.15.0 — browser rounds and automatic connection
- Collect browser annotations across pages in one round, grouped by page in the panel
and in one Send/Copy message. Keep page-local drafts, off-page note actions and global
round recovery. Browser protocol 6 uses review envelope v2 with per-note pages. - Register the Chrome native host and current/new sessions automatically. Resolve the
real Node.js executable during setup; no separate host-install or pairing command is
needed in normal use. Discover new sessions faster and share overlapping checks. - Replace
/annotate-webwith/annotate <url-or-html>, and remove/annotate-last;
plain/annotatestill reviews the latest completed reply. - Keep Send and Copy instead as separate actions. Choose destinations in one automatically
refreshed, filterable picker with current titles and activity/creation/title sorting. - Create empty OpenCode sessions from the extension without a prompt or model turn.
Disconnect/reconnect delivery without losing drafts or retries, and reconnect restarted
receivers by stable provider/session identity, carrying retries to the replacement. - Continue after confirmed text/browser annotation sends with
steer/resume: true:
idle sessions start immediately; running turns receive feedback at the next boundary. - Preserve Safari's existing sandboxed, copy-only boundary. Reload the Chrome extension
after updating; protocol and review-envelope changes require matching companion files.
Install or update
opencode plugin update @nxxxsooo/opencode-annotate@latestReload the Annotate Chrome extension and restart OpenCode after updating.
0.14.0 — references as prompts
References as prompts
/ref now submits the referenced conversation, your comment and any inline annotations
as one ordinary user prompt, rather than a compact reference item.
- Press Ctrl+T in the reference picker or use
/ref --tui <title or session ID>
to annotate the snapshot in the bundled reviewer. - Confirming continues an existing conversation. Before the first message, references
wait without starting the assistant; several can be added before you write. /refworks from OpenCode home, creating a destination only after confirmation.- Historical text stays quoted and bounded, with source IDs and timestamps. Switching
tabs does not redirect delivery.
Existing annotation/browser commands and their delivery behavior are unchanged.
Safari remains copy-only. No cross-agent hc functionality or third-party toolbar
artwork is included.
Install
opencode plugin add @nxxxsooo/opencode-annotate@latestUpdate
opencode plugin update @nxxxsooo/opencode-annotate@latest
opencode plugin listKeep existing plugin options. Run /reload if the command list has not refreshed.
The npm package includes the native reviewer for macOS arm64/x64, Linux arm64/x64
and Windows x64. Safari support is source/build support, not a signed application.
Verification
Release CI builds and checks all five native targets plus the Safari converter/Xcode
gate. Isolated OpenCode tests verify prompt admission and continuation intent while
suppressing model execution. The user confirmed the development prompt flow worked.
0.13.1 — review demos and search discoverability
OpenCode Annotate 0.13.1
A documentation and discoverability update. Runtime behavior is unchanged from 0.13.0.
- A clearer README introduces terminal review for AI replies and Markdown, browser webpage annotation, and conversation references.
- Real terminal and Chrome-panel captures show selection and comments using synthetic demo content, with reproducible capture sources and documented limits.
- Updated package description and relevant keywords make the review workflows easier to identify. Search engines control recrawling and ranking; no ranking improvement is claimed.
Install
opencode plugin add @nxxxsooo/opencode-annotate@latestUpdate
opencode plugin update @nxxxsooo/opencode-annotate@latestKeep your existing plugin options. Publication does not update an installed copy automatically. Requires OpenCode 2.2.0+; the terminal reviewer is bundled. Browser setup is optional and separate; Safari is copy-only. Windows terminal handoff remains unverified.
The release passed the five-platform native build/test matrix, Safari build gate and npm package checks. Local verification also covered 98 Node tests, 21 isolated OpenCode smoke scenarios and the reference suite, without a model turn. The unchanged browser runtime passed 33 headless scenarios during demo capture.
0.13.0 — auto-sizing reference comments
Auto-sizing /ref comments
Add an optional comment when referencing another conversation. The field grows and
shrinks with your text, wraps long lines, and scrolls at a screen-aware height limit.
Multiline paste and Chinese text keep their line breaks.
- Shift+Enter: new line.
- Enter: continue to the existing attachment confirmation.
- Esc or Ctrl+C: cancel without attaching.
Comments are separate from quoted history. Reference delivery is unchanged: it queues
context for the next prompt and does not start an idle assistant. This release does not
include the development-only inline reference annotations, references from home,
automatic continuation, Chrome session picker, or command consolidation.
Install
opencode plugin add @nxxxsooo/opencode-annotate@latestUpdate
opencode plugin update @nxxxsooo/opencode-annotate@latestKeep one server-plus-TUI plugin entry in opencode.json(c) and preserve your existing
options. Run /reload if the command list has not refreshed. Optional toolbar artwork
remains local; Safari remains a copy-only companion distributed as source/build support.
Tested with OpenCode 2.2.7: 98 Node tests, Rust formatting/Clippy/workspace tests,
21 isolated OpenCode smoke scenarios, and reference-editor growth/shrink, multiline CJK
paste, Shift+Enter, bounded scrolling, terminal resizing and cancellation. Smoke checks
do not start a model turn.
0.12.0 — Safari companion and compact review toolbar
Safari companion and compact review toolbar
- Safari companion: shared browser sources, a separate panel window, local annotation
rounds and Copy notes. Safari does not deliver directly to OpenCode sessions;
Chrome retains its existing pairing and delivery behavior. - Four compact TUI actions: approve, comment, Done (Enter) and Get (
g). Done
records that the requested work is finished; Get records understanding. Esc dismisses. - Optional user-supplied PNG toolbar artwork through Kitty graphics: one text row,
action-colored bold shortcuts, cached images and clean removal. No Lark artwork is
included. Unicode icons remain the default. - Explicit copy now confirms Copied to clipboard (N chars).
Install or update
opencode plugin add @nxxxsooo/opencode-annotate@0.12.0
# Existing installations:
opencode plugin update @nxxxsooo/opencode-annotate@latestPreserve existing plugin options and reload/reopen the terminal client afterward.
Checkout-based development installations must be updated separately.
Safari distribution
This release includes source and local build/install scripts, not a downloadable
signed/notarized Safari app. Build with Xcode and your own appropriate Apple signing
identity, then run npm run install:safari and enable the extension in Safari Settings.
See the README for the complete signing/build steps and the copy-only limitation.
Compatibility
- Node.js 22+, OpenCode 2.2+, Safari 18+ on macOS for the browser companion.
- PNG toolbar mode is explicit opt-in for verified Kitty-graphics terminals and local
artwork. Multiplexers are not supported by this trial; font/DPI changes require
remeasuring configured cell pixels. - Existing commands, including
/annotate-web, are retained. Unrelated unpublished
reference, continuation and Chrome session-picker changes are not in this release.