naive browser

Two spellings, one surface. naive computer browser <id> <verb> drives the browser on a computer; naive browser … holds what outlives the session — saved logins and who may reopen them. Options, guards and lifetime: the Browser guide.

Commands

Command	Description
`naive computer browser <id> goto <url>`	Navigate.
`naive computer browser <id> click <selector>`	Click a CSS selector.
`naive computer browser <id> type <selector> <text>`	Type into a CSS selector. Credential-shaped text is refused.
`naive computer browser <id> act <instruction>`	Do something described in words; `--var k=v` fills `%k%`.
`naive computer browser <id> extract [instruction]`	Read the page, a selector, or data shaped to `--schema`.
`naive computer browser <id> observe <instruction>`	List the elements that match a description.
`naive computer browser <id> links`	List the page’s links.
`naive computer browser <id> screenshot`	Capture a PNG; prints the `fil_` id.
`naive computer browser <id> status`	The open session, or `not_found`.
`naive computer browser <id> close`	Close the session. Idempotent.
`naive computer browser <id> save-context`	Save the open session’s login under a name.
`naive browser login <id>`	Sign in from the identity’s saved credential.
`naive browser signup <id>`	Register with a generated password and save it.
`naive browser credential save`	Seal a login credential into an identity’s vault.
`naive browser context grant <name>`	Let an agent or role reopen a saved login.
`naive browser context revoke <name>`	Delete a saved login and its grants.

Attach a browser

naive computer create takes the full option object; --browser attaches one on the open web and --allowed-domains attaches and scopes it.

naive computer create --name box --allowed-domains "app.example.com,*.example.com" \
  --timeout-minutes 20 --region eu-central --allow-writes --viewport 1280x720

Flag	Description
`--allowed-domains`	Comma-separated domains, or `*`. Optional — the open web by default.
`--timeout-minutes`	1–360, default 15.
`--region`	`us-west` (default), `us-east`, `eu-central`, `ap-southeast`.
`--viewport`	`<width>x<height>` in pixels.
`--os`	`windows`, `mac`, `linux`, `mobile`, `tablet`.
`--keep-alive`, `--block-ads`, `--stealth`, `--proxy`	Switches; all default off. `--proxy` needs a bounded allow-list, not `*`.
`--no-solve-captchas`	CAPTCHA solving is on by default; this turns it off.
`--allow-writes`	Permit write-looking `act`, `click` and `type`.
`--allow-extract`	Permit `extract`, `observe` and `screenshot` on a reopened saved login.
`--context-name`	Reopen a saved login by name. Needs a grant.
`--persist-context`	Write cookies back to `--context-name` at close.
`--human-login`	Start a human-first login; holds the saved login for 15 minutes until `save-context`.

Drive it

naive computer browser cmp_01H... goto https://app.example.com/
naive computer browser cmp_01H... act "search for %term%" --var term=naive
naive computer browser cmp_01H... extract "the product names and prices" --schema '{"type":"object"}'
naive computer browser cmp_01H... extract --selector "table.prices"
naive computer browser cmp_01H... links --contains docs --limit 20
naive computer browser cmp_01H... screenshot
naive computer browser cmp_01H... close

Every verb prints one browser_action (JSON by default, --human for a table). --var repeats; its values are sent once and never appear in the result. extract takes --selector and --schema (a JSON object); links takes --contains and --limit.

Saved logins

Save a credential first — the password comes from stdin, so it is never in your shell history or the process list. --password exists for CI, and --username sets the name typed into the login form when it is not the email (it defaults to --email).

printf '%s' "$FIGMA_PASSWORD" | naive browser credential save \
  --identity idn_01H... --service figma.com --email ada@example.com

Then sign in on a computer, save the login, and grant it:

naive browser login cmp_01H... --service figma.com --url https://figma.com/login --identity idn_01H...
naive computer browser cmp_01H... save-context --name figma --identity idn_01H... --service figma.com
naive browser context grant figma --identity idn_01H... --agent agt_01H...
naive browser context grant figma --identity idn_01H... --role member
naive browser context revoke figma --identity idn_01H...

grant takes exactly one of --agent <agt_…> or --role <owner|admin|member>. grant and revoke answer a signed-in dashboard session only; with an API key they exit with forbidden. signup registers a new account with a generated password and seals it into the identity’s vault:

naive browser signup cmp_01H... --service figma.com --url https://figma.com/signup \
  --identity idn_01H... --email ada@example.com

Getting started

Building & running

Organization

Identity

naive browser

Commands

Attach a browser

Drive it

Saved logins

​Commands

​Attach a browser

​Drive it

​Saved logins

Commands

Attach a browser

Drive it

Saved logins