
Mini Browser
A proper browser automation CLI that talks to Chrome over CDP and treats each action as a small Unix tool. You get the usual suspects like navigation, screenshots, and text extraction, but also genuinely useful stuff like snap (lists clickable elements with coordinates), fill (smart form filling by label or placeholder), and even design audits. The observe-then-act loop is clean: snap the page, grab coordinates, click or type at those coordinates, wait for the dust to settle, repeat. Works well for agents because everything is coordinate-based rather than brittle selector hunting. One recording at a time, viewport is fixed at 1024x768, and you'll need to scroll and snap again to find elements below the fold. Solid choice if you need an agent to actually drive a browser without fighting CSS selectors.
- skills.sh installs
- 2.4K
- GitHub stars
- 185
- last updated
- Aug 21, 2026
Install
$ npx -y skills add runablehq/mini-browser --skill mini-browser --agent claude-codeInstalls into .claude/skills of the current project.
Files
mini-browser (mb) — Browser CLI for Agents
mb is a browser CLI where each command is a small Unix tool. It talks to Chrome over CDP (port 9222) via puppeteer-core.
Setup (only if not already available)
Setup is only needed when mb is not installed or Chrome is not reachable.
Run these checks first — if both pass, skip straight to the Command Reference.
Check if ready
# 1. Is mb installed?
which mb && echo "mb: ok" || echo "mb: MISSING"
# 2. Is Chrome listening on CDP?
curl -sf http://127.0.0.1:9222/json/version > /dev/null && echo "chrome: ok" || echo "chrome: NOT RUNNING"
If both print "ok", everything is ready — go use mb commands directly.
Install (only if mb is missing)
npm install -g @runablehq/mini-browser
Start Chrome (only if not running)
mb-start-chrome
This launches Chrome with --remote-debugging-port=9222, a fresh profile, and a
1024×768 window. It no-ops if Chrome is already running.
To kill and relaunch:
mb-restart-chrome
Verify
mb go "https://example.com" && mb text
Environment Variables
Sponsors
Details
- Repository
- github.com/runablehq/mini-browser
- Categories
- AI & Agent Building, Automation & Workflows, Design & UI/UX, CLI & Terminal