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-code

Installs 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
1arize-ai avatararize-promptsarize-ai/arize-skillsINVOKE THIS SKILL for Arize Prompt Hub and `ax prompts` workflows: author or import templates and save (Workflows A–B), label/promote (C), or list/get/edit/dele2.4Kskills.sh installs
2apollographql avatarroverapollographql/skillsGuide for using Apollo Rover CLI to manage GraphQL schemas and federation. Use this skill when: (1) publishing or fetching subgraph/graph schemas, (2) composing2.4Kskills.sh installs
3triggerdotdev avatartrigger-cost-savingstriggerdotdev/skillsAnalyze Trigger.dev tasks, schedules, and runs for cost optimization opportunities. Use when asked to reduce spend, optimize costs, audit usage, right-size mach2.4Kskills.sh installs
4aas-ee avataropen-websearchaas-ee/open-websearchSingle entry skill for open-websearch setup and focused live retrieval, preferring local CLI/daemon paths while remaining compatible with workspace-exposed MCP 2.4Kskills.sh installs
5muxuuu avatarserenity-skillmuxuuu/serenity-skillTurn an investment agent into a supply-chain bottleneck hunter. Use this skill for source-backed investment research, live market/theme scans, AI/semi/technolog2.3Kskills.sh installs
6samuraigpt avatarmuapi-logo-creatorsamuraigpt/generative-media-skillsEngineer professional-grade brand logos using geometric primitives and negative space — generates minimalist, scalable vector-style marks via muapi.ai2.3Kskills.sh installs