Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Cli

Not yet published. Run it from the repository: bun packages/cli/src/cli.ts.
find, read, act, explore, typegen, explain, approvals, approve, deny, revoke, runs, ledger, verify, sites, actions, recipes, bench, usage, whoami, doctor, keys, policy, import, claim, watch, migrate, init, login, logout, mcp, update, completion.
act waits for the result. Give inputs as --set key=value (repeat it; values are typed from the action), --input '{...}', or piped JSON. --no-wait returns the run at once. typegen <domain> [--out file] writes TypeScript types for a site's actions. See use a website as an API.
Add --json for machine output. Input comes from --input or stdin (limit 1 MB).

exit codes

codemeaning
0ok
1error
2usage
3auth
4denied by policy
5rate limited
6approval pending
7needs a person (captcha, two-factor, session)
8payment required
9a postcondition failed

config

~/.config/orsel/config.json (mode 0600) holds the address, key and project. Environment variables ORSEL_URL, ORSEL_KEY, ORSEL_PROJECT beat the file; flags beat both. orsel doctor shows what is in use and checks clock skew.
orsel find "running shoes" --domain target.com searches one site by its words, through orsel's own index of it. orsel explore sends the site's pages to the crawler (robots.txt applies), so a site whose own search is drawn by JavaScript can still be searched; results are only as complete and as fresh as the crawl.
orsel update replaces the installed program with the version the site publishes, after checking its sha256 against /orsel-version.json. orsel update --check only says whether a newer one exists. A copy run from a source checkout is not replaced; use git pull there.
orsel watch <url or host> watches a page and orsel watch "some words" watches a search; when what it sees changes, the project's webhooks get watch.changed. Checks run every --every minutes (at least 15).