# Agent Browser

> Use for login-walled portals and headless browser automation with agent-browser. Skip public HTTP reading and explain-only questions.

- **Type:** Skill
- **Install:** `agentstack add skill-ahmadrosid-nakama-agent-browser`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ahmadrosid](https://agentstack.voostack.com/s/ahmadrosid)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ahmadrosid](https://github.com/ahmadrosid)
- **Source:** https://github.com/ahmadrosid/nakama/tree/main/packages/core/src/skills/bundled/agent-browser
- **Website:** https://ahmadrosid.github.io/nakama

## Install

```sh
agentstack add skill-ahmadrosid-nakama-agent-browser
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Use this skill when the task needs a **real browser**: login walls, forms, multi-step UI, or pages that `web_fetch` / `web_search` cannot reach.

Keep ordinary web work local:

- Use `web_fetch` for a single public HTTP(S) page that does not require login or interaction.
- Use `web_search` to discover sources.
- Do not open a browser just to read a public doc page.

## Prerequisites

- This profile must have the **`bash`** tool assigned.
- The host must have the [agent-browser](https://github.com/vercel-labs/agent-browser) CLI and Chrome installed:

```bash
npm install -g agent-browser
agent-browser install
```

If `bash` returns `command not found`, `ENOENT`, or similar for `agent-browser`, tell the operator to run the install commands above (and `agent-browser install --with-deps` on Linux if Chrome libraries are missing). Do not invent a different browser tool.

### Optional: CloakBrowser (stealth Chromium)

Stock Chrome from `agent-browser install` is the default. Use [CloakBrowser](https://github.com/CloakHQ/CloakBrowser) only when the site blocks that Chrome (bot detection / antibot). Cloak is **not** the default and is **not** bundled with Nakama.

The operator installs Cloak on the **same host** that runs `bash` and points agent-browser at Cloak's binary:

```bash
# Host env for the Nakama process (inherited by bash)
export AGENT_BROWSER_EXECUTABLE_PATH="/path/to/cloak-chromium"
export AGENT_BROWSER_ARGS=""
```

Get the binary path with `python -m cloakbrowser info` or `npx cloakbrowser info` after `cloakbrowser install`. Copy `AGENT_BROWSER_ARGS` from Cloak's [agent-browser integration](https://github.com/CloakHQ/CloakBrowser/blob/main/examples/integrations/agent_browser.sh). Do not invent flags.

If those variables are unset, keep using stock Chrome. Do not pass Cloak paths in each `bash` `env` unless the operator asked you to override the host env for this run.

## Browser workflow

Drive the browser with the `bash` tool. Multiple `agent-browser` commands in the **same agent run** share one daemon session — that is how login → navigate → act stays coherent.

1. Open the target (or launch without a URL if you must set cookies first):

```bash
agent-browser open https://example.com/login
```

2. Snapshot for token-efficient element refs (prefer interactive/ref output):

```bash
agent-browser snapshot -i
```

3. Act by ref from the snapshot (`@e1`, `@e2`, …). Re-snapshot after navigation or major UI changes — stale refs fail:

```bash
agent-browser fill @e3 "user@example.com"
agent-browser fill @e4 "secret"
agent-browser click @e5
agent-browser press Enter
```

4. Wait when the UI is loading:

```bash
agent-browser wait --load networkidle
```

5. Optional screenshot — write under the profile workspace `artifacts/` directory (bash cwd is the profile workspace). Prefer meaningful names; avoid capturing password fields:

```bash
agent-browser screenshot artifacts/browser-page.png
```

6. When the task is done (success or give-up), **close** the session so the next run starts fresh:

```bash
agent-browser close
```

If the daemon looks stuck, `agent-browser close --all` or `agent-browser doctor` can help.

### Timeouts

Default `bash` timeout is short. For browse/login steps, pass an explicit `timeoutMs` (tens of seconds to a few minutes per command as needed). Prefer one focused command per `bash` call so failures are easy to read.

### Session policy (v1)

- **Within one run:** reuse the same agent-browser daemon (do not close between every click).
- **Across runs:** do **not** use `--restore`, `state load`, or persistent Chrome profiles unless the user explicitly asks in this conversation. Re-authenticate when the task requires it.
- Always `close` at the end of the browser work in this run.

### Credentials

- Prefer credentials the user supplied in the prompt or already stored for this task.
- Do not echo passwords or session tokens in your final summary.
- Avoid screenshots of password fields.

### After the run

- Summarize what you did and what you learned in plain language.
- If a command failed (non-zero exit, timeout, missing CLI), explain clearly and either retry with a fresh snapshot or ask the user / operator for help.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ahmadrosid](https://github.com/ahmadrosid)
- **Source:** [ahmadrosid/nakama](https://github.com/ahmadrosid/nakama)
- **License:** MIT
- **Homepage:** https://ahmadrosid.github.io/nakama

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ahmadrosid-nakama-agent-browser
- Seller: https://agentstack.voostack.com/s/ahmadrosid
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.