mini-browser
mini-browser — a Claude Code skill from runablehq/mini-browser
Features
- ✓Command-line browser for agents
- ✓Compose commands with pipes and `&&`
- ✓Start Chrome with debugging port
- ✓Screenshot and snapshot features
- ✓Interactive element manipulation
- ✓Visit GitHub for more info
Installation Guide
As an agent skill (recommended)
npx skills add runablehq/mini-browser --all --globalThis installs the mini-browser skill for all your agents via skills.sh. Your agent will automatically know how to use mb commands.
As a global CLI
npm install -g @runablehq/mini-browserThen start Chrome
mb-start-chrome # starts Chrome with --remote-debugging-port=9222
mb go "https://example.com"var(--color-accent)]/40 pl-3 my-2 text-[var(--text-tertiary)]">Try it online at [runable.com — no install needed.
Also ships mb-restart-chrome to kill and relaunch the debug Chrome instance.
For local development: bun install && bun run build, then use node dist/mb.js.
Chrome scripts
| Script | What it does |
|---|---|
| mb-start-chrome | Launches Chrome with --remote-debugging-port=9222. No-ops if already running. Creates a fresh profile each time so --window-size=1024,768 is always respected. |
| mb-restart-chrome | Kills the running instance (via PID file) then calls mb-start-chrome. |
Both scripts honour these environment variables:
| Variable | Default |
|---|---|
| CHROME_PORT | 9222 |
| CHROME_BIN | auto-detected (google-chrome-stable, chromium, …) |
| CHROME_PID_FILE | <scripts>/.chrome-pid |
| CHROME_USER_DATA_DIR | <scripts>/.chrome-profile |