Changelog

Release history

3.1.2

September 21, 2026

Improved

  • Copy and Send auto-clear now covers notes that received a server ID during the action, including notes uploaded while joining a session.
  • Closing an MCP session cancels its in-flight tool calls and releases the session immediately.
  • --host also points the bundled stdio tools at the bound address, so a specific interface works without --http-url.

3.1.1

September 21, 2026

Added

  • A --host option and AGENTATION_HOST variable for the MCP server, for serving browsers on other machines.
  • agentation-mcp doctor checks that SQLite persistence is available for the running Node.js version.

Improved

  • Style isolation now covers inherited typography, so a host page's font, letter-spacing or text-transform never reaches the toolbar. A consumer className can hide the toolbar again.
  • The exported AnnotationPopupCSS and animated icon components bring their styles with them when used outside the toolbar.
  • Notes inside iframes follow in-frame hash and query changes.
  • Copy and Send auto-clear recognises notes that received a server ID during the action.
  • The MCP server answers the local browser and dev-server origins by default. --host and AGENTATION_CORS_ORIGINS open it up deliberately.

3.1.0

September 20, 2026

Added

  • An optional app name and configurable Copy formats for source paths, CSS classes or identifying attributes. Attribute-only selections can be saved without a comment.
  • An Open in editor callback for connecting available source locations to your editor.
  • A portalContainer prop for integrating with host modals and popovers.
  • Selection inside same-origin iframes, including nested frames, scaling, scrolling and navigation, and when Agentation itself is mounted inside an iframe.
  • Opt-in hash routing keeps feedback, layout state and MCP sessions separate by route. Global keyboard shortcuts can be disabled without disabling toolbar buttons or popup Enter/Escape.

Improved

  • Element names prefer short visible text and paths include identifying attributes like data-testid. Integrations that parse these strings should expect the new shapes.
  • Toolbar styles now render inside Shadow DOM. Importing Agentation no longer changes page styles or timers.
  • Deep selection through overlays and open shadow roots works with Cmd/Ctrl-click and drag multiselect. Legacy Cmd+Shift-click remains supported.
  • Accessible control names, native keyboard activation and focus return. Single-key shortcuts leave the page alone while Agentation is closed.
  • The companion MCP server handles concurrent events, reconnects and cancelled watch requests more reliably. Event history is bounded, browser-origin rules are consistent, and temporary webhook failures are retried.

Fixed

  • Copy, Send and Clear all stay reliable during overlapping actions, and each keeps its own success or failure state.
  • Annotation popups stay above the toolbar. Hover labels and toolbar positioning respect viewport edges, including after dragging.
  • Picking no longer activates underlying host controls when Block page interactions is enabled.
  • Callback-only Send is available, waits for asynchronous delivery and keeps feedback when delivery fails.
  • A React import interop crash affecting some React 19 setups.
  • Edits, deletions, layout notes and source locations survive MCP synchronization and reconnects.
  • Group selection moves placed components and existing sections together, with keyboard support in the Layout palette.
  • The MCP server requires Node.js 20 or newer. Node.js 24 LTS is recommended.

3.0.2

March 24, 2026

Fixed

  • Layout mode animations no longer freeze when the toolbar pauses page animations
  • Annotation textarea, settings panel, and color swatches no longer overflow their containers

3.0.1

March 24, 2026

Fixed

  • Fixed logo display on npm and settings panel

3.0.0

March 24, 2026

Show your agent where things go. Layout mode lets you place components, rearrange sections, and wireframe new pages. Your agent gets coordinates and dimensions instead of a paragraph of directions.

Added

  • Layout mode — press L to drag components onto the page, rearrange existing sections, or wireframe from scratch
  • Component palette with 65+ draggable types across five categories
  • Section detection and rearranging with snap guides, move badges, and CSS selector labels
  • Wireframe new page toggle with adjustable page opacity and a purpose field for context
  • AFS 1.1 — annotations carry a kind field so agents can distinguish feedback from placement and rearrange instructions

Improved

  • Cursor styles scoped to toolbar root, no longer leak into host page

2.3.3

March 14, 2026

Improved

  • Marker colors now use Display P3 on wide-gamut screens, with sRGB fallback

Fixed

  • className prop can now override toolbar positioning without !important

2.3.2

March 9, 2026

Fixed

  • Host page SVG icons broken by unscoped fill protection rule (e.g. Tailwind's fill-current)
  • Toolbar icon states rendering simultaneously when host CSS overrides inline opacity
  • Annotation textarea losing focus when annotating inputs inside modals and drawers (Radix, shadcn, vaul)
  • Next.js App Router internals (SegmentViewNode) shown instead of actual React component names

2.3.1

March 9, 2026

Fixed

  • Host app keyboard shortcuts firing while typing in annotation text areas and settings inputs

2.3.0

March 7, 2026

Added

  • Source file detection — annotations now include the source file path and line number (e.g. src/components/Button.tsx:42), works with Next.js, Vite, Webpack, and Turbopack
  • className prop for custom toolbar positioning
  • "Hide Until Restart" setting to dismiss the toolbar per-tab

Improved

  • Toolbar CSS fully isolated from host page styles
  • Instant tooltips when moving between toolbar buttons
  • sideEffects: false for better tree-shaking

Fixed

  • Dev mode detection for non-standard environments
  • Send button pointer events not registering
  • Toolbar portal events triggering host app click-outside handlers
  • Resolved and dismissed annotations reappearing after sync

2.2.1

February 11, 2026

Fixed

  • An issue where the toolbar button would occasionally become unresponsive to clicks and drags

2.2.0

February 6, 2026

Improved

  • Animation pause now freezes all page animations — CSS, JavaScript timers, requestAnimationFrame, Web Animations API, and videos — and resumes exactly where they left off

2.1.1

February 5, 2026

Fixed

  • Unstyled "Learn more" link in MCP Connection settings when no endpoint is configured

2.1.0

February 5, 2026

Added

  • Hands-free mode — watch_annotations tool blocks until new annotations appear, then returns a batch for the agent to process in a loop
  • Keyboard shortcut Cmd+Shift+F / Ctrl+Shift+F to toggle feedback mode
  • Resolved annotations now animate out of the browser UI in real time via Server-Sent Events

Fixed

  • Production builds no longer health-check localhost:4747 on every page load
  • MCP tools no longer hang indefinitely if the SSE connection drops

Removed

  • wait_for_action MCP tool — unused and superseded by watch_annotations

2.0.0

February 5, 2026

The shift from "annotate, copy, paste" to "annotate and collaborate." Agents now see your annotations directly. This update adds MCP server integration, webhooks, React component detection, Shadow DOM support, and much more.

Added

  • MCP server for direct agent integration — agents can fetch, acknowledge, resolve, and dismiss annotations
  • HTTP API and Server-Sent Events for real-time updates
  • Per-page sessions with rich annotation metadata (timestamps, status, resolver info)
  • Status transitions: pending → acknowledged → resolved/dismissed, all timestamped
  • Annotation Format Schema with intent and severity fields for prioritization
  • JSON Schema and TypeScript definitions for the annotation format
  • Webhooks to subscribe to annotation events with structured JSON payloads
  • React component detection — shows full component hierarchy on hover, not just DOM elements
  • Shadow DOM support — annotate elements inside modals, web components, and design systems that use shadow DOM
  • Toolbar position persists in localStorage — drag it once, it stays where you put it
  • Cmd+Shift+Click multi-element selection — hold ⌘+⇧ and click elements to select multiple individually, release to annotate the group

Improved

  • Component detection adapts to output detail level (Compact, Standard, Detailed, Forensic)
  • Cursor styles in settings panel — I-beam for text inputs, pointer for clickable items
  • Individual element highlights on hover — cmd+shift multi-select annotations show each element separately, not one combined box
  • "Block page interactions" now enabled by default — prevents accidental clicks while annotating (can be toggled off in settings)

Fixed

  • Fixed/sticky element positioning — annotations on fixed navs and sticky headers now position correctly regardless of scroll
  • SVG icons broken by host page fill styles — now uses attribute selectors to avoid conflicts
  • Query params and hash fragments now preserved in copied feedback URL

1.3.2

January 24, 2026

Improved

  • Unified quote text styling between marker tooltip and annotation popup
  • Tooltip font and padding consistency

Fixed

  • Blurry tooltip text on marker hover (counter-scaled to offset parent transform)

1.3.1

January 23, 2026

Added

  • Custom tooltips with arrows on toolbar buttons
  • Subtle stroke around marker dots for better visibility

Improved

  • Help icon design and tooltip styling

1.3.0

January 23, 2026

Added

  • Collapsible computed styles section in annotation popup — click the chevron to view CSS properties for the selected element

Improved

  • Toolbar polish and visual refinements

1.2.0

January 22, 2026

Added

  • Programmatic API: onAnnotationAdd, onAnnotationDelete, onAnnotationUpdate, onAnnotationsClear, onCopy callbacks
  • copyToClipboard prop to control clipboard behavior

1.1.1

January 22, 2026

Added

  • Claude Code skill for automatic setup (npx skills add benjitaylor/agentation)

Fixed

  • React key prop warning in color picker

1.1.0

January 21, 2026

Improved

  • Package exports now have proper TypeScript type conditions

Removed

  • Deprecated AgentationCSS export alias (use Agentation instead)

1.0.0

January 21, 2026

First stable release. Click elements to annotate them, select text, drag to multi-select. Multiple output detail levels, keyboard shortcuts, customizable marker colors, and localStorage persistence.