bim-bro

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'

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

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 (alive = host pid running AND port answers)

open

bim bro open --url <url> [--site <site>]

open a URL in a tab of a LIVE session (default: built-in scratch browser, started detached on demand)

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

page

bim bro page --site <site> --action <action> [--arg <arg>] [--tab <tab>] [--wait <wait>] [--max <max>] [--reload <reload>] [--full <full>] [--out <out>]

drive a LIVE session tab by site id: tabs|text|eval|goto|click|type|key|shot|capture|close

• --site <site> (required) -- site
• --action <action> (required) -- action
• --arg <arg> -- arg
• --tab <tab> -- tab
• --wait <wait> -- wait
• --max <max> -- max
• --reload <reload> -- reload
• --full <full> -- full
• --out <out> -- out

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> [--detach <detach>]

start/stop a live browser session (start needs --detach via the driver; attached start is INTERACTIVE -- use the bro CLI)

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

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'

Then ask your assistant to run bim describe --json. See what the installer does.