0xnyn/canary/canary-review

Canary review (triage)

Open recorded sessions in the local viewer and summarize what happened. Sessions live in ~/.canary/sessions/<id>/ — each has results.json, report.html, and trace / video / HAR / console / screenshots.

When to use

• Browsing or replaying recorded sessions.
• Triaging a run: which steps passed/failed, console errors, network failures.
• Opening the report or the trace for a specific session.

Examples

Example 1: open the viewer

User says: "open the canary viewer" or "let me see my sessions" Run npx @usecanary/ui (a local server, like npx playwright show-trace) in the background and give the URL. Pass --dir <path> for a non-default folder.

Example 2: triage the last run

User says: "what failed in the last session?" or "summarize the latest run" Read the newest ~/.canary/sessions/*/results.json, summarize steps (pass/fail, durations, console/network issues) with the report.html path, then open the viewer.

Workflow

1. Browse: npx @usecanary/ui (--dir <path> for a non-default sessions folder). List sessions

without the UI via npx @usecanary/cli session list; check what's running with npx @usecanary/cli status [--session <id>].

1. Summarize: read the session's results.json (steps, summary, artifacts) and report pass/fail

with counts; cite the report.html path.

1. Review is read-only — don't modify session files.