# Aim Browser

> >

- **Type:** Skill
- **Install:** `agentstack add skill-brianv1981-aim-browser-aim-browser-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BrianV1981](https://agentstack.voostack.com/s/brianv1981)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [BrianV1981](https://github.com/BrianV1981)
- **Source:** https://github.com/BrianV1981/aim-browser/tree/master/aim-browser.skill

## Install

```sh
agentstack add skill-brianv1981-aim-browser-aim-browser-skill
```

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

## About

# aim-browser

Agent CLI on the **aim-browser** engine. Prefer **one-verb skills** (google-ai, page-fetch, …) when they fit; use this skill for open-ended exploration.

## Defaults

| Policy | Behavior |
|--------|----------|
| Window | **Minimized** (`--start-visible` / `--visible` to watch) |
| After new tab | Re-minimized (Chrome often un-minimizes) |
| CDP | Loopback only (`127.0.0.1`) |
| Profile | Sensitive — do not log cookies/secrets |

Prefer the **daemon** over ad-hoc headless Chrome.

## Setup

```bash
cd /path/to/aim-browser && npm install
npm run skill -- --start    # or: node aim-browser.skill/scripts/run.js --start
npm run skill -- --check
```

Install into a vessel: `npm run install-skills --  --mode symlink`  
(or link `aim-browser.skill` into the host skills path).

## Flags (left → right; tab state kept)

**Lifecycle:** `--start` · `--start-minimized` · `--start-visible` · `--show` · `--minimize` · `--maximize` · `--check` · `--stop`

**Tabs:** `--list` · `--open ` · `--use ` · `--close []`

**Navigate / wait:** `--url ` · `--wait-ready` · `--wait-selector ` · `--wait ` · `--scroll-to-bottom` · `--solve-px`

**Discover:** `--elements` · `--content` · `--content-ax` · `--html` · `--screenshot ` · `--fullpage` · `--imgsave `

**Interact:** `--click` · `--tap` · `--tapxy` · `--taptestid` · `--type` · `--textbox` · `--keytype` · `--keypress` · `--keycombo`

**Env / advanced:** `--eval ""` · `--block-media` · `--spy ` · `--dlpath` · `--upload` · `--resize` · `--interactive` / `--repl`

## Examples

```bash
npm run skill -- --start --open "https://example.com" --elements

npm run skill -- \
  --url "https://example.com" \
  --type 2 "query" \
  --keypress enter \
  --wait-selector ".results" \
  --screenshot /tmp/results.png
```

## Engine (scripts)

After exploration, permanent jobs import the package:

```javascript
import { AimBrowser, startDaemon, stopDaemon } from 'aim-browser';
```

See repo `README.md` and `SECURITY.md`. Seamless headed (Xvfb): `docs/SEAMLESS_HEADED.md`.

## Source & license

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

- **Author:** [BrianV1981](https://github.com/BrianV1981)
- **Source:** [BrianV1981/aim-browser](https://github.com/BrianV1981/aim-browser)
- **License:** MIT

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-brianv1981-aim-browser-aim-browser-skill
- Seller: https://agentstack.voostack.com/s/brianv1981
- 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%.