Title: HXRV &#8211; AI-Ready Visual Review
Author: youheiokubo
Published: <strong>July 7, 2026</strong>
Last modified: July 7, 2026

---

Search plugins

![](https://ps.w.org/hxrv-ai-ready-visual-review/assets/banner-772x250.png?rev=3598848)

![](https://ps.w.org/hxrv-ai-ready-visual-review/assets/icon-256x256.png?rev=3598848)

# HXRV – AI-Ready Visual Review

 By [youheiokubo](https://profiles.wordpress.org/youheiokubo/)

[Download](https://downloads.wordpress.org/plugin/hxrv-ai-ready-visual-review.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/hxrv-ai-ready-visual-review/#description)
 * [Reviews](https://wordpress.org/plugins/hxrv-ai-ready-visual-review/#reviews)
 * [Development](https://wordpress.org/plugins/hxrv-ai-ready-visual-review/#developers)

 [Support](https://wordpress.org/support/plugin/hxrv-ai-ready-visual-review/)

## Description

Most feedback tools collect comments. HXRV turns them into a fix pipeline.

Reviewers click any element on the live page to pin a comment. Threads are discussed
and resolved Figma-style. Then, instead of leaving a pile of tasks for a human to
decipher, HXRV exports every open comment as a structured Markdown brief – selectors,
element text, warnings included – ready to be handed directly to an AI coding agent
such as Claude Code. The agent locates the template, the engineer reviews the diff,
the reviewer checks the box.

**What makes HXRV different**

 * **AI-ready export.** The fix brief records each comment’s CSS selector, an excerpt
   of the element’s text, dynamic-content warnings (“this pin sits inside a posts
   loop – fix the template, not the content”), and anchor-lost notices. An AI coding
   agent can grep your theme and go straight to the right file. No other feedback
   tool produces agent-consumable output.
 * **Element-anchored pins.** Most tools store pins as page coordinates, so they
   drift on responsive layouts. HXRV anchors comments to the element itself: CSS
   selector plus a relative offset inside it. Pins follow their element at any viewport
   width.
 * **Three-stage anchor fallback.** When a template edit breaks a selector, HXRV
   re-anchors by the element’s saved text excerpt; if that fails too, the comment
   moves to an orphan tray instead of silently disappearing – and the export flags
   it so nobody (human or AI) acts on a stale pointer. Restore the element and the
   comment re-anchors itself.
 * **Truly self-hosted.** Everything lives in one custom table in your own database.
   No SaaS account, no external requests, no tracking. Install it for a review cycle,
   uninstall it, and every trace is gone – including the table.
 * **Lightweight by design.** Powered by htmx and Alpine.js, bundled locally (~100
   KB total). No build step, no jQuery, no React widget injected into your client’s
   site. Assets load only in review mode for authorized users.
 * **Zero settings screens.** Configuration is code: filters (`hxrv_capability`,`
   hxrv_export_markdown`) and CSS custom properties (`--hxrv-primary` and friends)
   for restyling the overlay from your theme.

**The workflow**

 1. A reviewer (client, editor, designer) opens the page, clicks an element, leaves
    a comment.
 2. Threads collect replies; finished items get resolved.
 3. The engineer exports the open comments as a Markdown brief and pastes it into an
    AI coding agent – or reads it themselves.
 4. Fixes land, boxes get checked, the plugin can be removed without a trace.

Part of the HX Series (HXFE – forms, HXSE – search): htmx-powered WordPress tools
that send HTML over the wire, skip the build step, and cut every feature that is
not essential.

## FAQ

### Where is my data stored?

In a custom table (`wp_hxrv_comments`) in your own WordPress database. Nothing is
sent to any external service. Uninstalling the plugin removes the table completely.

### Who can leave comments?

Logged-in users with the `edit_pages` capability (administrators and editors) by
default. Change it with one line in your theme’s functions.php:

    ```
    add_filter( 'hxrv_capability', fn() => 'publish_posts' ); // authors and above
    add_filter( 'hxrv_capability', fn() => 'edit_posts' );    // contributors and above
    add_filter( 'hxrv_capability', fn() => 'read' );          // any logged-in user
    ```

For a review-only client account, return a custom capability (e.g. `hxrv_review`)
and add it to the client’s role with `add_cap()` – they get commenting rights without
any editing rights. External reviewer share links (no login required) are planned
for a future version.

### My theme already loads htmx / Alpine.js. Will they load twice?

No. HXRV detects common script handles (`htmx`, `alpinejs`, and friends) and reuses
your theme’s copy instead of loading its own, while guaranteeing the load order 
the overlay needs. If your theme registers them under custom handles, declare them
via the `hxrv_htmx_handles` / `hxrv_alpine_handles` filters.

### How do I start a review?

Click “HXRV Review” in the admin bar on any front-end page, or append `?hxrv` to
the URL while logged in.

### What is the AI export for?

It turns open review comments into a structured Markdown brief. Paste it into an
AI coding agent (Claude Code, etc.) and the agent can locate the relevant template
files using the recorded CSS selectors and element text.

### Does it work with the block editor and custom blocks?

Yes. Comments anchor to the rendered DOM, so classic templates, block content, and
custom blocks all work. Elements inside dynamic loops (latest posts, query blocks)
are flagged as possibly dynamic.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“HXRV – AI-Ready Visual Review” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ youheiokubo ](https://profiles.wordpress.org/youheiokubo/)

[Translate “HXRV – AI-Ready Visual Review” into your language.](https://translate.wordpress.org/projects/wp-plugins/hxrv-ai-ready-visual-review)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hxrv-ai-ready-visual-review/),
check out the [SVN repository](https://plugins.svn.wordpress.org/hxrv-ai-ready-visual-review/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/hxrv-ai-ready-visual-review/)
by [RSS](https://plugins.trac.wordpress.org/log/hxrv-ai-ready-visual-review/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * First stable release on WordPress.org.
 * Pin navigation: numbered chips in the toolbar jump to each comment and pulse 
   its marker.
 * Reuse the theme’s htmx / Alpine.js when already registered, preventing double-
   loading (filterable via `hxrv_htmx_handles` / `hxrv_alpine_handles`).
 * Bidirectional anchor-status sync: orphaned comments automatically return to open
   if the element re-appears.
 * Updated bundled libraries: Alpine.js 3.15.12, htmx 2.0.10.

#### 0.1.0

 * Initial release.
 * Element-anchored pin comments with threaded replies and resolve flow.
 * Text-excerpt re-anchoring and orphan handling.
 * Admin overview grouped by page.
 * AI-ready Markdown export of open comments.

## Meta

 *  Version **1.0.0**
 *  Last updated **18 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [AI](https://wordpress.org/plugins/tags/ai/)[comments](https://wordpress.org/plugins/tags/comments/)
   [feedback](https://wordpress.org/plugins/tags/feedback/)[review](https://wordpress.org/plugins/tags/review/)
   [visual feedback](https://wordpress.org/plugins/tags/visual-feedback/)
 *  [Advanced View](https://wordpress.org/plugins/hxrv-ai-ready-visual-review/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/hxrv-ai-ready-visual-review/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hxrv-ai-ready-visual-review/reviews/)

## Contributors

 *   [ youheiokubo ](https://profiles.wordpress.org/youheiokubo/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hxrv-ai-ready-visual-review/)