Aim Browser

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

Prefer the daemon over ad-hoc headless Chrome.

Setup

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 -- <skills-dir> --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 <url> · --use <index> · --close [<index>]

Navigate / wait: --url <url> · --wait-ready · --wait-selector <css> · --wait <ms> · --scroll-to-bottom · --solve-px

Discover: --elements · --content · --content-ax · --html · --screenshot <path> · --fullpage · --imgsave <path>

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

Env / advanced: --eval "<js>" · --block-media · --spy <pattern> · --dlpath · --upload · --resize · --interactive / --repl

Examples

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:

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

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