Run TypeScript automation workflows against your own, logged-in Chrome. Each workflow is a .ts file exporting a Zod schema and an async run(stagehand, args). Wrap workflows in tasks to get cron scheduling, deduped Atom feeds, and change-detection notifications — all from a single daemon on your machine.
Built on Stagehand (self-healing DOM automation) and Playwriter (CDP relay for your real Chrome).
npm install -g @browserclijs/browser-cli
browser-cli config # configure LLM provider (interactive)See Prerequisites for the Chrome / Playwriter / apprise setup.
Full docs — concepts, design philosophy, features — live in docs/ and are published as a bilingual static site (coming soon on Cloudflare Pages).
Start reading:
- Introduction — what browser-cli is and who it's for
- Design Philosophy — the three-layer triage that shapes every workflow
- Workflow — the core unit
- Task — scheduled, stateful wrappers
- Features — concurrency, self-heal, BYO-Chrome, subscriptions
Working workflows in examples/:
hn-top.ts— Hacker News front page (raw Playwright, stable markup)github-repo-summary.ts— GitHub repo metadata via network interception
MIT