Commands
Page and tab commands share three flags: --tab <id> (default: the active tab), --browser <id> (only when several browsers are connected) and --json. Ids come from reins tabs.
Delegate
reins do hands a small task to TypeSafe's Jev model, which picks each click. Your agent supplies every typed value and checks the result. Needs a TypeSafe key (reins key set typesafe). How it does: Benchmarks.
reins do '<goal>' [--fill name=value]... [--confirm '<label>']... [--max-steps 30] [--timeout 60] [--tab <id>] [--browser <id>] [--json]
Run the task. Exit 0 when Jev says done (verify it), 2 when it stops for input, 1 on error. Every stop prints the exact next command.
reins do --continue [--fill ...] [--confirm ...]
Resume the tab's last run with the missing value or approval. Runs are remembered for 15 minutes.
Tabs and pages
reins tabs [--browser <id>]
List tabs across all connected browsers.
reins groups [--browser <id>]
List tab groups. reins tabs marks each grouped tab with g<id>.
reins group --tab <id> [--tab <id> …] [--group <gid>] [--title <t>] [--color <c>] [--collapse|--expand]
Put tabs in a new group, or in an existing one with --group. With --group and no --tab, edit the group.
reins ungroup --tab <id> [--tab <id> …] | --group <gid>
Take tabs out of their group, or dissolve a whole group. Tabs stay open.
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. Snapshot and refs reach into open shadow roots; a CSS selector matches the light DOM only.
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 tighten the per-site policy, never loosen it. Grants happen in the extension popup.
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 extension --reload
Re-stage and reload an unpacked (dev or sideloaded) extension in place.
reins allow <id>
Allow an unpacked or dev extension to connect.
reins audit [--denied]
Render the audit trail, or only what policy blocked.
reins key set|status|clear [typesafe]
Save, check or remove the TypeSafe key that powers reins do. The key is read without echo and stored in ~/.reins/credentials.json.
reins restart
Restart the background daemon (after an upgrade or reins allow).
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.