{
"markdown": "![\"tracelane\"](\"https://raw.githubusercontent.com/Cubenest/rrweb-stack/main/assets/brand/sub-tracelane.svg\")
![\"peek\"](\"https://raw.githubusercontent.com/Cubenest/rrweb-stack/main/assets/brand/sub-peek.svg\")
\n\n# rrweb-stack\n\nTwo OSS products on one rrweb-based substrate. Both ship as `npm` packages today.\n\n| Product | One line | Install |\n|---|---|---|\n| **[tracelane](packages/tracelane-wdio/)** | The recorder for your WebdriverIO and Playwright tests — Cypress on the roadmap. Self-contained HTML for every run — replay failures, audit successes, attach to any bug tracker. No SaaS, no dashboard, no signup. | `npx @tracelane/cli init` |\n| **[peek](packages/peek-cli/)** | Your real browser, exposed to your AI coding agent over MCP — the agent reads recorded sessions and, with your explicit consent, drives the live page. Never leaves your machine. | `npm install -g @peekdev/cli && npx peek init` |\n\n\n\n*Above: `npx @tracelane/cli init` in a real WebdriverIO project — detect runner, install, edit `wdio.conf.ts`, ignore reports dir.*\n\n\n\n*Above: `peek sessions list` then `peek sessions show ... --format markdown` — a recorded browser session as queryable structured output, AI-ready.*\n\n[](https://github.com/Cubenest/rrweb-stack/actions/workflows/ci.yml)\n[](https://scorecard.dev/viewer/?uri=github.com/Cubenest/rrweb-stack)\n[](LICENSE)\n[](https://github.com/Cubenest/rrweb-stack#pre-launch-state)\n[](https://github.com/Cubenest/rrweb-stack/blob/main/CONTRIBUTING.md)\n[](https://github.com/changesets/changesets)\n[](https://biomejs.dev)\n\n## What's where\n\n### tracelane\n\n| Package | Status | What it does |\n|---|---|---|\n| [`@tracelane/wdio`](packages/tracelane-wdio/) | alpha | WebdriverIO Service — capture + write HTML report |\n| [`@tracelane/playwright`](packages/tracelane-playwright/) | alpha | Playwright Reporter + auto-fixture — capture + write HTML report |\n| [`@tracelane/cypress`](https://github.com/Cubenest/rrweb-stack/issues) | planned | JSON-output adapter (no Test Replay overlap) |\n| [`@tracelane/core`](packages/tracelane-core/) | alpha | Framework-agnostic capture engine — depended on by the adapters |\n| [`@tracelane/report`](packages/tracelane-report/) | alpha | Self-contained HTML report builder |\n\nDocs: [tracelane.cubenest.in](https://tracelane.cubenest.in) (source under [`apps/tracelane-docs/`](apps/tracelane-docs/)). The [tracelane-wdio README](packages/tracelane-wdio/README.md) is the right starting point.\n\n### peek\n\n| Package | Status | What it does |\n|---|---|---|\n| [`@peekdev/cli`](packages/peek-cli/) | alpha | `peek init` installer + `peek sessions` query / export |\n| [`@peekdev/mcp`](packages/peek-mcp/) | alpha | stdio MCP server — exposes captured sessions, plus consent-gated live read + act tools, to Claude Code, Cursor, Cline, Windsurf |\n| [`peek-extension`](packages/peek-extension/) | alpha · [on the Chrome Web Store](https://chromewebstore.google.com/detail/peek/dmgpmkeneheenpdnfmpjjahnkknkaejb) | Chrome MV3 extension — the real browser, recorded |\n\nDocs: [peek.cubenest.in](https://peek.cubenest.in) (source under [`apps/peek-docs/`](apps/peek-docs/)).\n\n> **peek requires Node.js ≥ 22.** Its native `better-sqlite3` dependency only\n> ships prebuilt binaries for Node 22+; on older Node (notably Windows, which\n> has no C/C++ toolchain by default) the install falls back to compiling from\n> source and fails.\n\n## Shared substrate\n\n[`@cubenest/rrweb-core`](https://github.com/Cubenest/rrweb-stack/blob/main/packages/rrweb-core/) — vendored PostHog rrweb fork, PII masking primitives, large-DOM throttling, screenshot fallback, network/console capture abstractions, compression helpers. Used by both products. The fork is pinned by SHA + the substrate's NOTICE attributes both PostHog's plugin lineage and the upstream rrweb roots.\n\n## Why two products, one repo\n\nSame recording engine, same trust model, two different consumer surfaces:\n\n- **tracelane** ships test-time captures into a self-contained HTML artifact your team and AI agents can read offline.\n- **peek** ships live-browser captures into an MCP server your AI coding agent can query — and, with your explicit per-origin consent, drive the live page through.\n\npeek's live read + act tools are gated by a five-level per-origin permission model (`0 Off → 1 Read-only → 2 Suggest-only → 3 Act-with-confirm → 4 YOLO`, the default is Level 1) with a destructive-action blocklist that always prompts. No telemetry, no cloud — everything stays in `~/.peek`.\n\nShared upstream means one fork to track, one masking surface to harden, one license + DCO + security policy.\n\n## Pre-launch state\n\nPre-1.0. Alpha packages live on npm. Branch protection is on `main` (PR + CI + DCO + linear history). All workflows use Trusted Publishing OIDC + SLSA provenance. Renovate runs with a 7-day cooldown (21 days for the `@posthog/rrweb` lineage) and `config:best-practices`. tracelane has publicly launched (npm alpha + a live demo report); peek is alpha on npm and its Chrome MV3 extension is available on the [Chrome Web Store](https://chromewebstore.google.com/detail/peek/dmgpmkeneheenpdnfmpjjahnkknkaejb).\n\n## Security\n\nReport a vulnerability via [SECURITY.md](https://github.com/Cubenest/rrweb-stack/blob/main/SECURITY.md). The shared threat model for both products lives in [docs/SECURITY-NOTES.md](https://github.com/Cubenest/rrweb-stack/blob/main/docs/SECURITY-NOTES.md).\n\n## License\n\nApache-2.0. See [LICENSE](https://github.com/Cubenest/rrweb-stack/blob/main/LICENSE).\n\n## Contributing\n\nApache 2.0. DCO sign-off required on all contributions. See [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), [SECURITY.md](SECURITY.md).\n\n## Sponsor / support\n\n- GitHub Sponsors — [github.com/sponsors/harry-harish](https://github.com/sponsors/harry-harish) *(opening for launch)*\n- The work is open-source and sustainable; sponsorship keeps it that way. See [`docs/SUSTAINABILITY.md`](docs/SUSTAINABILITY.md) for the maintenance cadence.\n",
"bytes": 6813,
"sha": "dcf8080c44301183670ab496f5ddb482e55a97e94ee611060c62a4a2c9e038f6",
"repo_slug": "cubenest/rrweb-stack",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_cubenest_peek_mcp_6caffc8c/readme"
}