[b1zya]

A bare patchright-cli printed the whole manual. It now prints the home view: what is already open in this workspace and what to run next, so an agent arriving in a workspace continues a session instead of opening a second one. The idea comes from the home view in AhaiMk01/patchright-cli; the implementation is ours, client-side only.

patchright-cli 0.2.0 (patchright-core 1.64.3) - anti-detection browser automation for AI agents

Browsers open in this workspace (2):
- default: headless chrome, 2 tabs, current about:blank
  closes after 30m without a command, closes when process 145380 exits
- work: headless chrome, profile work, 1 tab, current "Example Domain" https://example.com/
  closes after 30m without a command, closes when process 145380 exits

Next:
  patchright-cli snapshot             element refs of the current page
  patchright-cli -s=<name> <command>  act in another session
  patchright-cli list --all           sessions in every workspace
  patchright-cli --help               all commands; <command> --help for one

With nothing open it says so and points at open <url> and env.

How it works

• src/commands/home.ts: reads this workspace's session files, connects to each daemon in parallel and asks tab-list (raw) with a 1.5 s budget. A daemon that refuses the connection is skipped (stale file, left in place: the view is read-only); one that does not answer in time shows as busy; one started by a newer client shows as incompatible with an open hint, since this client refuses to drive it.
• It starts nothing and does not touch the activity file, so looking does not keep an idle session alive.
• --json returns the same as data (sessions[] with status, headed, profile, tabs, current, lifetime, plus next[]). --help is unchanged and still the manual.
• src/program.ts (forked): the bare-run branch calls the home view; the --help branch is as before. The Agent skill: line moved into a shared variable and shows in both.

Docs and tests

• SKILL.md: run bare patchright-cli after env, and continue an open session instead of opening another; README and CHANGELOG mirror it.
• tests/unit/home.spec.ts: tab-list parsing, workspace filtering, stale/busy/incompatible sessions, hints. tests/integration/isolation.spec.ts: empty view, a named session with its current page, --json, --help.
• npm run check, npm run test:unit (133), npm run test:integration (23) pass locally on Windows. Measured 0.14 s with two live sessions.

🤖 Generated with Claude Code