{
  "markdown": "# Subtext, by Fullstory\n\n**Session replay, built for agents.** Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can review what real users did, reproduce reported bugs, verify its own UI changes, and manage capture privacy rules, all without leaving the terminal.\n\n## Get started\n\nThe fastest way in is the [setup wizard](https://github.com/fullstorydev/subtext-wizard). Run it in your project directory:\n\n```sh\nnpx @subtextdev/subtext-wizard\n```\n\nOne command handles the whole setup: it logs you in, fetches your org's capture snippet, asks which analytics tools you use, then hands the install off to your own coding agent — which wires up the capture snippet, MCP server, skills, and commands for you. Takes a few minutes.\n\n**Requires a free Subtext account — no credit card.** Subtext is a hosted service that records and stores your app's sessions. Your account is where they live, and where your agent reads them from. When the wizard opens the login page, create an account in one click with Google, then come back to finish.\n\n_EU data region? Run `npx @subtextdev/subtext-wizard --region eu`._\n\n## What you get\n\nOnce setup is done, your agent has these tools:\n\n- **Session review** — point your agent at a recorded session and it walks through what happened: the flow the user took, console errors, network activity, and where things broke. Great for debugging user-reported issues or confirming a fix landed in the real UI.\n- **Privacy rules** — detect PII in captured sessions and manage element-block, URL, and network capture rules directly from your agent.\n\nDriving a *live* browser and capturing before/after proof of code changes live in the companion **[Subtext Verify](https://github.com/fullstorydev/subtext-verify)** plugin.\n\n## Set up manually\n\nPrefer to wire things up yourself? The wizard just automates the steps below — you can do them by hand instead.\n\n**1. Install the plugin**\n\n**Claude Code**\n```\n/plugin marketplace add fullstorydev/subtext\n/plugin install subtext@subtext-marketplace\n```\n\n**Cursor** — install from the Marketplace panel (or a Team Marketplace that imports this repo).\n\n**Codex** — open `/plugins`, install **subtext** from the repo marketplace.\n\n**Gemini CLI**\n```\ngemini extensions install https://github.com/fullstorydev/subtext\n```\n\n**Manual / openskills**\n```\nnpx openskills install fullstorydev/subtext\n```\n…then add the `subtext` MCP server (below) to your agent's MCP configuration.\n\n**2. Connect the MCP server**\n\nThe `subtext` server runs at `https://api.fullstory.com/mcp/subtext` (EU1 mirror: `https://api.eu1.fullstory.com/mcp/subtext`). It's HTTP only — no local process required.\n\n**3. Add the capture snippet to your app**\n\nInstall the Fullstory capture snippet for your org so sessions are recorded. The wizard does this for you against your org's snippet; to do it by hand, grab your snippet from your Fullstory settings.\n\n## Notes\n\n- All tools are read-only analysis **except** `privacy-create` / `privacy-promote` / `privacy-delete` / `privacy-url-create` / `privacy-network-create`, which modify org privacy rules.\n- This plugin bundles the **skills** `subtext-review` (structured session summaries), `subtext-session` (the `review-*` tool catalog), `subtext-privacy` (PII detection + element-block/URL/network privacy rules), and `subtext-telemetry` (workflow milestone logging), plus `subtext-shared` and `subtext-using-subtext`.\n- It also bundles the **sightmap** skills `sightmap-authoring` and `sightmap-browser` for building and driving a [`.sightmap/`](https://github.com/sightmap/sightmap) corpus, with `subtext-sightmap` bridging a corpus into session review. These are vendored from the [sightmap](https://github.com/sightmap/sightmap) project (see below) — no extra install, and no binary required at plugin install time.\n\n## Maintaining the vendored sightmap skills\n\nThe `sightmap-authoring` and `sightmap-browser` skills under `skills/` are\n**vendored** from the [sightmap](https://github.com/sightmap/sightmap) project\n— do not hand-edit them. They ship inside the `@sightmap/sightmap` npm package;\nSubtext pins that package as a devDependency and copies the skills in via\n`scripts/sync-sightmap-skills.mjs`.\n\nTo update them:\n\n```sh\nnpm install --save-dev @sightmap/sightmap@<version>   # bump the pin\nnpm run vendor-skills                                 # refresh skills/ + .sightmap-vendored.json\n```\n\nThen commit the result. `.sightmap-vendored.json` records the source package and\nexact version vendored. Fixes to the skills' content belong upstream in the\nsightmap repo, not here.\n",
  "bytes": 4699,
  "sha": "8b13dbbe4ec65336f40e6ce03fc97575df29334ef330978b4988cb7dcfa53917",
  "repo_slug": "fullstorydev/subtext",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_fullstorydev_subtext_cef5fd87/readme"
}