# CLI

Part of the Oya Browser docs. All of it: https://oyabrowser.com/docs.md

## CLI

```
oya login                       Save an API key for this machine
oya init                        Model, browser provider, solver, desktop sign-in
oya start [--persona auto]      Start a browser and print its id
oya goto <url>                  Navigate (defaults to the newest browser)
oya ask "<prompt>"              Drive it in plain language
oya ls                          What is running
oya rm <id> | --all             Stop browsers
oya personas [new|rm <id>]      Identities and their concurrency
oya open                        Watch a browser work
oya playbooks                   Saved playbooks
oya playbooks export <name>     One playbook as JSON [--out <file>]
oya playbooks import <file>     Save an export here [--name <n>] [--replace]
oya config [key=value ...]      This key's settings
oya usage                       What this key has spent
oya stealth-test [--live]       Score this deployment against bot detectors
```

Flags and `OYA_API_KEY` / `OYA_BASE_URL` beat the saved file, so CI never needs `oya login`. The key is stored at `~/.oya/config.json`, mode 600.