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.
Copy-on-writeIndependent CDPFresh entropy
Authenticated catalog workspace
3 / 3 branches 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.
↻
Dead network connections are re-established after the browser returns.
—
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.
ONE STATE APIKeep the progress that matters.