admin.northstar.test / catalog
CATALOGAUTHENTICATED
Products
FORK SOURCEcp_72baREADY
Checkpoint the live session before a risky action. If the workflow breaks, return to the state that worked.
LIVE
LIVE SESSIONCheckout ready
THE STATE APIOne primitive.
Three operations.
Three operations.
01
checkpoint()Preserve a safe point in the live session.
02
rewind()Return to the exact browser state that worked.
03
fork(n)Branch parallel futures from one checkpoint.
NEXTOne session.
Fork an authenticated checkpoint into isolated live sessions. Give each branch a different job, then keep moving without repeating login, setup, or navigation. The source stays live, so the default three-session allowance supports two children.
Copy-on-writeIndependent CDPFresh entropy
Authenticated catalog workspace
Source + 2 children live
Source state remains immutablebranches continue independently
POST /v1/sessions/sess_8f13/forkNot a page reload.The browser itself.
A checkpoint preserves the live browser process and its client-side state together. Rewind returns to that complete safe point—not a URL, screenshot, or reconstructed approximation.
STATE CUTAWAYCHECKPOINT OBJECT
vm / memorypage / liveorigin / stateworker / statesession / authFULL LIVE STATEcp_72ba
RECOVERY CONTRACTPrecise about the boundary.
Restores client-side browser state, including the live page, storage and authenticated context.
↻
Rewind replaces the browser. Reconnect and rediscover targets; live connections and stale handles are not preserved.
—
Does not reverse irreversible actions already accepted by the server.
Keep your browser stack.Add a way back.
brawsr owns the browser lifecycle and state operations. Your client library stays in control through authenticated CDP.
playwright-rewind.tsTYPESCRIPT
connectOverCDP
Reconnect Chromium and rediscover the restored pages.
01import { chromium } from "playwright-core";02import { BrawsrClient } from "@brawsr/sdk";03
04const brawsr = new BrawsrClient({05 apiKey: process.env.BRAWSR_API_KEY!,06});07const session = await brawsr.createSession();08const cdp = brawsr.connectCDP(session);09
10let browser = await chromium.connectOverCDP(11 cdp.endpointUrl,12 { headers: cdp.headers },13);14
15const checkpoint = await brawsr.createCheckpoint(session.id, {16 label: "before-action",17});18
19// Attempt the browser action.20const restored = await brawsr.rewind(session.id, checkpoint);21const next = brawsr.connectCDP(restored);22
23browser = await chromium.connectOverCDP(next.endpointUrl, {24 headers: next.headers,25});AFTER REWIND
Same endpoint. Fresh connection. Rediscover pages and targets.
old handles → staleYOUR CLIENTSTABLE CDP ENDPOINTCURRENT BROWSER
STATE API
checkpoint()rewind()fork(n)Explicit. Framework-neutral.
Progress shouldsurvive failure.
Agents, scrapers, and automations spend time building state before the hard part begins. Preserve that progress, then recover or branch from it.
LIVE RUN TRACEAGENT WORKFLOWS
SESSION ACTIVEsess_8f13 / current run
state operations remain explicitYour browser statestays yours.
Isolation follows the session from live execution through checkpoint storage and every forked branch. The boundary does not disappear when state moves.
sess_8f13 / project northstar
BOUNDARIES ACTIVE
SESSION BOUNDARY
sess_8f13ACTIVEPROJECT STATE STOREnorthstar / checkpointsPROJECT-SCOPED
No cross-project deduplication
EARLY ACCESS OPEN
Start from a browserthat remembers.
Review free-alpha limits and recovery boundaries in the quickstart. Need help choosing a safe point? Talk to the founder.
ONE STATE APIKeep the progress that matters.