Commands

The CLI is the whole interface — agents shell out to it, and so can you. Every command accepts --tab <id> (defaults to the active tab), --browser <id> (only needed when several browsers are connected — ids come from reins tabs), and --json for raw results.

Tabs & 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 friends.

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 shortcut.

reins hover (--ref <e#> | --selector <css>)

Hover an element — menus, 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> [--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 --level warning…]

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 don't wrap.

reins daemon

Run the daemon in the foreground (normally auto-spawned).

Management

reins browsers

List browsers connected to the daemon.

reins status

Daemon state, port, and connected browsers.

reins allow <id>

Allow an unpacked/dev extension to connect.

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 a command's usage.