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 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> [--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).

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 but 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/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.