bim-bro

Run authenticated browser workflows with no AI in the loop. A human signs in once -- bro stores only the session, never a password -- and recorded flows then re-run headlessly to pull invoices, statements, and other documents from vendor portals. Playwright under the hood; the browser and its Chromium are managed for you.

Verbs

Verb	What it does
bim bro doctor	health check (node, playwright, sites)
bim bro version	driver name + version
bim bro list	sites x workflows x auth freshness
bim bro sessions	live CDP browser sessions
bim bro run --site <site> --workflow <workflow> [--month <month>] [--dateStamp <dateStamp>] [--headed <headed>]	run a site workflow (download/read/write)
bim bro test --site <site> --workflow <workflow> [--month <month>] [--dateStamp <dateStamp>]	dry-run a workflow (stages, ships nothing)
bim bro run-all --kind <kind> [--month <month>]	run every workflow of a kind across sites
bim bro auth --site <site>	capture site auth (INTERACTIVE -- use the bro CLI, not the driver)
bim bro session --op <op> --site <site>	start/stop a live browser session (INTERACTIVE -- use the bro CLI)

doctor

bim bro doctor

health check (node, playwright, sites)

version

bim bro version

driver name + version

list

bim bro list

sites x workflows x auth freshness

sessions

bim bro sessions

live CDP browser sessions

run

bim bro run --site <site> --workflow <workflow> [--month <month>] [--dateStamp <dateStamp>] [--headed <headed>]

run a site workflow (download/read/write)

• --site <site> (required) -- site
• --workflow <workflow> (required) -- workflow
• --month <month> -- month
• --dateStamp <dateStamp> -- dateStamp
• --headed <headed> -- headed

test

bim bro test --site <site> --workflow <workflow> [--month <month>] [--dateStamp <dateStamp>]

dry-run a workflow (stages, ships nothing)

• --site <site> (required) -- site
• --workflow <workflow> (required) -- workflow
• --month <month> -- month
• --dateStamp <dateStamp> -- dateStamp

run-all

bim bro run-all --kind <kind> [--month <month>]

run every workflow of a kind across sites

• --kind <kind> (required) -- kind
• --month <month> -- month

auth

bim bro auth --site <site>

capture site auth (INTERACTIVE -- use the bro CLI, not the driver)

• --site <site> (required) -- site

session

bim bro session --op <op> --site <site>

start/stop a live browser session (INTERACTIVE -- use the bro CLI)

• --op <op> (required) -- op
• --site <site> (required) -- site