> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Browser validation

> Inspect rendered web changes with a bounded Playwright smoke check.

```bash theme={null}
arka browser_check http://127.0.0.1:3000 --json
arka "check the frontend in a browser"
```

Arka loads the page headlessly with `wait_until="load"`, then waits for a
configurable settle delay (safe for WebGL/Canvas apps), captures a full-page
screenshot, records page errors, and reports the HTTP status and title. Install
the optional browser runtime with:

```bash theme={null}
pip install playwright
playwright install chromium
```

For a Vite/WebGL app, use a longer settle delay when needed:

```bash theme={null}
arka browser_check http://localhost:5174 --settle 4 --json
# or: ARKA_BROWSER_SETTLE_SECONDS=4 arka browser_check http://localhost:5174 --json
```

If Playwright is missing, Arka prints the exact install commands above. A
browser check is read-only; console/WebGL errors are reported so they can be
fixed in the app.

## Declarative cross-platform app tests

Arka can run the same browser workflow on macOS, Linux, and Windows:

```bash theme={null}
arka automate http://localhost:3000 --steps '[{"action":"click","selector":"button"},{"action":"assert_text","selector":"body","text":"Done"}]' --json
```

Supported actions are `goto`, `click`, `fill`, `press`, `wait`, `assert_text`,
and `screenshot`. Screenshots are temporary unless `--output` is supplied.
Use `--headed` while developing a workflow; review the generated steps before
running them against production applications.

For native desktop apps, use the optional PyAutoGUI backend:

```bash theme={null}
arka automate unused --backend desktop --steps '[{"action":"click","x":400,"y":300},{"action":"type","text":"hello"},{"action":"screenshot"}]'
```

Desktop steps support `click`, `type`, `hotkey`, `press`, `wait`, and
`screenshot`. They never launch an app or perform shell commands implicitly;
launch the target app separately and keep coordinates specific to the test
environment.

```

This is validation only; it does not edit code or retry builds automatically.
```


## Related topics

- [MCP integration for Cursor and Claude](/guides/mcp.md)
- [Open URL in browser](/guides/open-url.md)
- [Arka Ideate](/guides/ideate.md)
- [Compose slides](/guides/compose-slides.md)
- [Kaggle datasets](/guides/kaggle.md)