rrweb-stack AGENTS.md

Project instructions for rrweb-stack, a monorepo—a single repository containing multiple related products. They explain the products, shared code, setup, testing, and where planning information lives.

In plain words
What is it for?
Use them when developing or testing tracelane, a failed-test recorder, or peek, a local browser-session debugging and reproduction tool.
Why use it?
They help an agent understand which product a change belongs to and how the products share their foundation.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/cubenest/rrweb-stack/agents-md
Clone the repo
git clone --depth 1 https://github.com/Cubenest/rrweb-stack

Made for: Codex, OpenCode.

Per session 1,915 This file is loaded in full into every session.
When invoked 1,915 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01915 $0.01915
Opus 5 $0.00958 $0.00958
Sonnet 5 $0.00383 $0.00383
Haiku 4.5 $0.00192 $0.00192

Measured yesterday against content hash 85ceacd82304, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

rrweb-stack AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 155 lines

How it starts

The opening of the file, as written. The whole thing — 155 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project context for AI coding assistants

This is the canonical, vendor-neutral instruction doc for any coding agent working in this repo (Codex, Cursor, Cline, Copilot, Zed, Windsurf, Aider, Gemini CLI, and others). Claude Code reads it too, via an @AGENTS.md import in the sibling CLAUDE.md. Edit this file, not CLAUDE.md. It documents what every AI-assisted session should know before making changes: what the repo is, how to build and test it, and where the planning context lives.

What the repo is

Cubenest/rrweb-stack is a monorepo that publishes two independent products on a shared substrate:

  • tracelane (npm scope @tracelane) — failed-test recorder for end-to-end suites (WebdriverIO today, Playwright + Cypress on the roadmap). Captures rrweb session + console + failed-network responses, ships a self-contained HTML report on failure. Apache-2.0.
  • peek (npm scope @peekdev) — local-first browser-session forensics + repro for AI coding agents. Passively records masked sessions of your real browser to a local SQLite store via a native host, and exposes them — DOM history, console/network errors, the action before an error, and session→Playwright repro — to coding agents through an MCP server. Apache-2.0.
  • @cubenest/rrweb-core — the shared rrweb fork used by both products (PostHog's fork + a framework-agnostic network plugin).

Both products are pre-1.0 alpha, side-project–maintained, no paid infrastructure, no telemetry, no cloud. See docs/SUSTAINABILITY.md for the maintenance posture and docs/SECURITY-NOTES.md for the threat model.

The build is pnpm + Turbo + Changesets. WXT 0.20 for the Chrome MV3 extension. Vitest 3. Astro 6 for the two docs sites (needs Node >=22.12). Lefthook for pre-commit lint (biome + custom checks).

Build, test & dev commands

pnpm workspace (pnpm@9, Node >=22). From the repo root:

  • pnpm install — install all workspaces.
  • pnpm build — build every package (pnpm -r build, Turbo-orchestrated).
  • pnpm test — run the Vitest suites across packages (pnpm -r test).
  • pnpm typecheck — type-check every package (pnpm -r typecheck).
  • pnpm lint / pnpm lint:fix — Biome check (and autofix) the repo. Note Biome ignores apps/**, .astro, and build output.
  • pnpm changeset — author a changeset for any user-visible change to a published package (required; see conventions below).

Read the full file on GitHub · 155 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 155 lines · 1,915 tokens per session scan A 85ceacd82304

Subscribe to this mod's changes

rrweb-stack AGENTS.md is an instructions file published in the GitHub repository Cubenest/rrweb-stack (7 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,915 tokens to every session, about $0.0096 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.