{
  "markdown": "# Subtext Verify\n\nDrive a hosted browser, capture before/after proof of code changes, and leave\nreviewer-facing evidence (screenshots, viewer links, comments) against your\nrunning app — for coding agents.\n\nSubtext Verify is a **companion plugin** to [Subtext](https://github.com/fullstorydev/subtext).\nIt layers a live-browser proof workflow on top of a normal Subtext install — it\nis not a standalone product.\n\n## Prerequisite: install Subtext first\n\nInstall [Subtext](https://github.com/fullstorydev/subtext) the usual way before\nadding Verify. Subtext provides the pieces Verify builds on:\n\n- the **`subtext` MCP server** (HTTP) that also serves Verify's `live-*` /\n  `comment-*` / `doc-*` / `artifact-*` / `clip-*` tools (gated server-side by org\n  flag),\n- the general MCP conventions and security rules in Subtext's `subtext-shared`,\n- the canonical `sightmap-authoring` / `sightmap-browser` skills for the\n  `.sightmap/` schema.\n\nVerify assumes all of that is present; it only adds what's needed to *use the\nverify tools*.\n\n## What this plugin adds\n\n- **Skills** — `subtext-proof` (before/after visual evidence, the inner loop),\n  `subtext-onboard` and `subtext-first-session` (first-run flows), the tool\n  catalogs `subtext-live` / `subtext-comments` / `subtext-docs` /\n  `subtext-tunnel`, the `subtext-recipe-sightmap-setup` recipe, and\n  `subtext-verify-shared` (verify-specific conventions). All skill names are\n  `subtext-verify-*`-namespaced or unique, so nothing collides with Subtext.\n- **MCP server** — only the **`subtext-tunnel`** stdio client (reverse tunnel for\n  localhost dev servers), run via\n  `npx -y @subtextdev/subtext-cli@latest tunnel mcp`. The shared `subtext` HTTP\n  server is already configured by base Subtext, so Verify does not redeclare it.\n- **Hook** — a `SessionStart` hook injects the `subtext-verify-using` router so the\n  agent reaches for `subtext-proof` before editing UI code.\n\n## Install\n\n**Claude Code**\n```\n/plugin marketplace add fullstorydev/subtext-verify\n/plugin install subtext-verify@subtext-marketplace\n```\n\n**Cursor** — install from the Marketplace panel (or a Team Marketplace that\nimports this repo).\n\n**Codex** — open `/plugins`, install **subtext-verify** from the repo marketplace.\n\n**Gemini CLI**\n```\ngemini extensions install https://github.com/fullstorydev/subtext-verify\n```\n\n**Sightmap upload dependency (optional).** The sightmap collector script needs\n**Python 3.9+ and PyYAML** (`pip install pyyaml`). Only needed if the project has\na `.sightmap/` corpus you want reflected in snapshots and network traces.\n\n## Getting started\n\nA good first run is one real change proven end-to-end — ask your agent something\nlike *\"prove a small UI change on my local dev server.\"* Under the hood it will:\n\n1. **Connect to your running app.** For a local server, follow the tunnel-first\n   flow (`live-tunnel` → `tunnel-connect` → `live-view-new`) and share the\n   `trace_url` so you can watch live; the same link replays afterward. See\n   `subtext-tunnel`.\n2. **Capture before/after proof.** Snapshot the affected area, make the change,\n   re-capture, and package screenshots + trace into a proof document. See\n   `subtext-proof`.\n3. **Bootstrap a sightmap (optional).** Record what was learned about the touched\n   components into `.sightmap/` so the next agent starts ahead. See\n   `subtext-recipe-sightmap-setup`.\n\n`subtext-onboard` walks a new user through exactly this on their first run.\n\n## Notes\n\n- The `subtext` tool surface is gated server-side by org/feature flag; Verify\n  assumes the verification flag is enabled for your org.\n- Read-only review of completed sessions and privacy-rule management live in\n  [Subtext](https://github.com/fullstorydev/subtext) itself, not here.\n",
  "bytes": 3741,
  "sha": "681e0d80bb43c7b0fa45af57c09dd8afffae731dbb192fe31ad54d0d9056cc1b",
  "repo_slug": "fullstorydev/subtext-verify",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_fullstorydev_subtext_verify_c2ffe4ff/readme"
}