{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-tools-state-capture-markers",
  "slug": "tools-state-capture-markers",
  "title": "Just-in-time state capture (markers)",
  "summary": "Tool roles, alternatives, selection tradeoffs, and compatibility caveats.",
  "category": "Tools",
  "tags": [
    "tools",
    "state-capture-markers"
  ],
  "sources": [
    {
      "label": "Tool comparison reference",
      "url": "https://dewy-sleet-n5zs.here.now/#state-capture-markers"
    }
  ],
  "sourceUnits": [
    "resources/index.html#state-capture-markers"
  ],
  "collection": "factory",
  "categoryId": "tools",
  "wordCount": 322,
  "url": "/topics/factory-tools-state-capture-markers/",
  "markdownUrl": "/markdown/factory-tools-state-capture-markers.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-tools-state-capture-markers.json",
  "headings": [
    {
      "id": "just-in-time-state-capture-markers",
      "text": "Just-in-time state capture (markers)",
      "level": 2
    },
    {
      "id": "pick-this-if",
      "text": "Pick this if…",
      "level": 3
    }
  ],
  "markdown": "# Just-in-time state capture (markers)\n\nTool roles, alternatives, selection tradeoffs, and compatibility caveats.\n\n## Just-in-time state capture (markers)\n\n**John uses:** **agent-markers** (section 09; pattern page at [mindful-mango-accy.here.now](https://mindful-mango-accy.here.now/)) — a \\<300-line, dependency-free recorder: console/fetch/error/click patched into a ring buffer, a  Mark keystroke pins one sentence of human testimony to nearby events, and the export renders into a redacted agent-ready debug packet. The differentiator is *testimony as a first-class artifact* and privacy-by-redaction.\n\n| Alternative | What it is | How it differs | License |\n|----|----|----|----|\n| [rrweb](https://github.com/rrweb-io/rrweb) | Record and replay the web: DOM-level session recording library | Full DOM replay vs markers' redacted event trail; the building block most replay products use | MIT |\n| [OpenReplay](https://github.com/openreplay/openreplay) | Self-hostable session replay + product analytics for reproducing issues | Always-on infrastructure with a server; markers is a one-file, moment-of-surprise capture | NOASSERTION (ELv2/MIT mix) |\n| [Highlight](https://github.com/highlight/highlight) | OSS full-stack monitoring: session replay, errors, logs, traces | Monitoring-platform scale; check current repository activity | NOASSERTION (Apache-2.0 core) |\n| [Sentry Session Replay](https://github.com/getsentry/sentry) | Session replay wired to error tracking in Sentry | Error-first: replays attach to exceptions rather than to human testimony | NOASSERTION (FSL) |\n| [Jam](https://jam.dev/) | Chrome extension: one-click bug reports with replay, console logs, network requests, device details | Commercial, human-in-the-loop like markers — the closest 'press a button at the moment of surprise' product; output targets issue trackers, not agent prompts | commercial (free tier) |\n\n### Pick this if…\n\n- **Jam** — the closest commercial \"press a button at the moment of surprise\" tool; output targets issue trackers rather than agent prompts.\n- **rrweb** — you're building your own marker system and want full DOM replay under it.\n- **OpenReplay / Highlight** — you want always-on capture infrastructure you control.\n- **Sentry** — your entry point is errors, not human testimony.\n- Or lift the workshop's recorder itself — it's ~300 dependency-free lines, designed for exactly this."
}
