Quickstart

Documentation

Quickstart

Run the current pre-release build locally, open the deterministic laptop-research fixture, and inspect the receipt-first close contract without using real browsing data.

Pre-release statusThis repository is under active construction. The web site documents the intended safety contract; verify extension behavior against the code and tests before using it on irreplaceable state.

Requirements

1. Install and build

terminalcopy
pnpm install
pnpm extension:build
pnpm web:build

The extension build output location is printed by WXT. Load that unpacked directory from your browser’s extension-management page while developer mode is enabled.

2. Generate the synthetic demo fixture

terminalcopy
pnpm demo:generate
pnpm demo:serve

Open http://127.0.0.1:4317, allow popups for the local fixture, then click Open research window. It creates 43 deterministic local pages: sources, duplicates, search pages, four expected keeps, and known unresolved questions.

3. Start a checkout

  1. Focus the fixture window.
  2. Open Tab Checkout.
  3. Select Checkout this window.
  4. Review every keep/close recommendation before approving.
  5. Confirm that the receipt exists before any close action.
Synthetic expected plan43 tabs reviewed, 39 proposed closes, and 4 keeps: configuration, live price, unresolved battery comparison, and checkout. The user must still review and bulk-confirm the proposals.

4. Verify the receipt

A portable receipt is paired with a separate portable snapshot. The receipt stores reviewed decisions, cited facts, unresolved work, privacy provenance, current status, distinct close/restore outcomes, and integrity values that link the two documents.

checkout record statescopy
capturing_snapshot → extracting / analyzing → building_receipt
→ preview_ready → closing → closed / partial

Those progress states live in the extension’s checkout journal; they are not embedded as lifecycle history in the portable receipt. If the flow fails before closing, no tab closes. See the receipt format for field-level detail.

Before real use