] [--provider ] [--name ] [--governed] [--budget-usd ]` | Launch browser instance and print its ID and CDP endpoint |\n| `oya goto ` | `[--id ]` | Navigate to URL (defaults to newest browser) |\n| `oya ask \"\"` | `[--id ]` | Drive page using configured AI model |\n| `oya open` | `[--id ]` | Launch interactive SSE live view in system browser |\n| `oya ls` | `[--json]` | List active fleet browsers with health status |\n| `oya status` | `[--id ] [--json]` | Detailed metrics, error counts, and recent activity log |\n| `oya rm ...` | `[--all]` | Terminate target browser or entire fleet |\n\n### Persona Management (Anti-Ban Identities)\n\n```bash\n# List all saved personas and active concurrency\noya personas\n\n# Create a new persona with fixed device parameters\noya personas new us-shopper --platform MacIntel --tz America/New_York --locale en-US --max 2 --geo US\n\n# Preview generated hardware fingerprint without saving\noya personas new --preview --platform Win32 --tz Europe/London\n\n# Clone an existing persona (same hardware fingerprint class, clean cookie jar)\noya personas clone --name us-shopper-backup\n\n# Edit persona concurrency cap or residential proxy geo\noya personas edit --max 4 --geo US\n\n# Delete a persona and its stored cookie jar\noya personas rm \n```\n\n### Moving logins (`oya cookies`)\n\nA persona's cookie jar is its logins. Sign in once, then carry the session to wherever it is needed:\n\n```bash\n# Save a persona's logins to a file (owner-readable only: it holds live sessions)\noya cookies export --out logins.json\n\n# The same, shaped for Playwright's context.addCookies()\noya cookies export --format playwright --out pw-cookies.json\n\n# Bring logins in from a file: an export, or any JSON list of cookies\noya cookies import logins.json\n\n# Give one persona another persona's logins (each keeps its own device)\noya cookies copy \n```\n\n### Human-in-the-Loop Takeover\n\nWhen automation encounters hardware 2FA, phone biometric approvals, or complex verification:\n\n```bash\n# 1. Acquire human control lease (pauses agent execution safely)\noya takeover \n\n# 2. Complete manual verification via interactive live view\noya open --id \n\n# 3. Release control when done\noya release \n\n# 4. Acknowledge and resume autonomous agent execution\noya resume \n```\n\n### Governance, Auditing & Webhooks\n\n```bash\n# View fleet overview, spend rate cards, and limits\noya control\n\n# Inspect durable sessions (including cleanup-pending or disconnected nodes)\noya sessions [id]\n\n# Force termination of an unresponsive session\noya stop --force\n\n# Read durable append-only lifecycle events\noya events [--after ]\n\n# Audit hourly token and sandbox spend\noya usage\n\n# Mint scoped service credentials\noya credential new --role operator --label \"ci-runner\"\n\n# Register an HMAC-signed webhook for fleet lifecycle events\noya webhook new https://api.mycorp.com/oya-events\n```\n\n### Stealth Benchmarking\n\nBenchmark your browser deployment against live detection platforms (CreepJS and Bot.Sannysoft). The harness lives in `server/`, so run this from a checkout of the repo, or set `OYA_SERVER_DIR`:\n\n```bash\n# Run local evasion probe suite\noya stealth-test\n\n# Run live benchmark against detection platforms\noya stealth-test --live\n```\n\n---\n\n## 🤖 CI/CD & Headless Environments\n\nIn automated pipelines (GitHub Actions, GitLab CI, Docker), use flags or environment variables to bypass interactive prompts:\n\n```bash\nexport OYA_API_KEY=\"oya_live_...\"\nexport OYA_BASE_URL=\"https://oyabrowser.com\"\n\n# Non-interactive launch with JSON output\noya start --provider browserbase --persona auto --json\n```\n\n| Global Flag | Description |\n| :------------ | :---------------------------------------- |\n| `--key ` | Override API key for command |\n| `--url ` | Override control plane URL |\n| `--id ` | Target specific browser instance ID |\n| `--json` | Output pure JSON for programmatic parsing |\n\n---\n\n## 📄 License\n\nMIT © [Oya](https://getoya.ai)\n\n## Deploy a self-hosted control plane\n\n`oya install` offers Docker, Kubernetes, Amazon ECS and Google Cloud/GKE using\nthe repository's existing `deployments/` examples. `--target k8s` skips the target\nmenu; `--dry-run` previews without writes. Version 2 plans replay with\n`oya install --config oya-install.json`. Bare `--yes` and version 1 plans keep\nthe original SQLite/Docker quickstart. See [the installer guide](../../docs/self-hosting.md).\n","readmeFilename":"README.md"}
![\"NPM](\"https://img.shields.io/npm/v/@oya-ai/cli?color=39ed35&label=@oya-ai/cli&logo=npm\")
\n ![\"License:](\"https://img.shields.io/badge/license-MIT-blue.svg?color=39ed35\"){kind=icon}
\n ![\"Node](\"https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg\"){kind=icon}
\n![\"oya](\"https://raw.githubusercontent.com/OyadotAI/oya-browser/main/assets/cli-demo.svg\")
\n