Commands
The CLI is the whole interface: agents shell out to it, and so can you. The commands that act on a page or a tab share three flags: --tab <id> (the active tab by default), --browser <id> (only needed when several browsers are connected, and the ids come from reins tabs) and --json for raw results. The management commands (status, doctor, kill, help) take none of them.
Tabs and pages
reins tabs [--browser <id>]
List tabs across all connected browsers.
reins open <url> [--background]
Open a new tab.
reins close --tab <id>
Close a tab.
reins focus --tab <id>
Focus (activate) a tab.
reins nav <url|back|forward|reload> [--tab <id>]
Navigate a tab.
Interaction
Interaction commands address elements by ref (from reins snapshot) or by CSS selector.
reins snapshot [--tab <id>] [--max-chars <n>]
List interactive elements with refs. The refs feed click, type and the rest.
reins click (--ref <e#> | --selector <css>) [--button right|middle] [--count 2]
Click an element.
reins type (--ref <e#> | --selector <css>) --text "…" [--enter]
Type into an element. --enter presses Enter afterwards.
reins fill (--ref <e#> | --selector <css>) --value "…"
Set an input's value directly, faster than type.
reins select (--ref <e#> | --selector <css>) --value "…"
Choose a select option by value or label.
reins press --key "Escape" | "Meta+A" | "Shift+Tab"
Press a key or a shortcut.
reins hover (--ref <e#> | --selector <css>)
Hover an element, for menus and tooltips.
reins scroll [--ref <e#> | --selector <css> | --by "dx,dy" | --to top|bottom]
Scroll an element into view, by a delta, or to an edge.
reins upload (--ref <e#> | --selector <css>) --file <path> […]
Set files on a file input.
reins wait (--ref <e#> | --selector <css>) [--state visible|hidden|attached]
Wait for an element to reach a state.
reins dialog (--accept | --dismiss) [--text "…"] [--tab <id>]
Answer the open alert, confirm or prompt.
reins resize --width 1280 --height 800 [--tab <id>]
Resize the tab's browser window.
Reading
reins text [--ref <e#> | --selector <css>] [--max-chars <n>]
Read the page's (or an element's) visible text.
reins screenshot [--tab <id>] [--full] [--format jpeg] [--out <path>]
Capture the page. Prints the image file path.
reins console [--tab <id>] [--since <ms>] [--level error …]
Read recent console messages.
reins network [--tab <id>] [--since <ms>] [--url <pattern>]
Read recent network requests.
Advanced
reins eval '<expression>' [--await]
Evaluate JavaScript in the page and print the value.
reins cdp <Domain.method> ['<json-params>'] [--tab <id>]
Raw Chrome DevTools Protocol call. The escape hatch for cookies, geolocation, PDF, tracing and everything else the curated commands do not wrap.
reins daemon
Run the daemon in the foreground. Normally it is auto-spawned.
Site permissions
The shell can inspect and tighten the per-site policy, never loosen it. Grants happen in the extension popup. See the Site permissions page for the full model.
reins policy [--browser <id>]
Show the default tier, the rules, and the effective tier for each open tab's host.
reins policy deny <pattern>
Block a site entirely. The pattern is a host or a *.wildcard.
reins policy readonly <pattern>
Tighten a site to read-only: agents can look, not act.
reins policy allow <pattern>
Always errors. Grants require the extension popup, and the error message says exactly that.
Management
reins browsers
List browsers connected to the daemon.
reins status
Daemon state, port, and connected browsers.
reins extension
Stage the bundled extension for install without the Chrome Web Store (Load unpacked).
reins allow <id>
Allow an unpacked or dev extension to connect.
reins audit [--denied]
Render the audit trail, or only what policy blocked.
reins kill
Stop the background daemon.
reins doctor
Run diagnostic checks.
reins logs
Show the daemon log location and recent lines.
reins help [command]
Overall help, or one command's usage.