bwb-browser

Browser Without Bloat — 76KB. 25 tools. Zero dependencies. Runs on your phone.

A lightweight MCP server that gives any AI agent browser superpowers. Written by a guy in India on Termux because the existing tools were 200MB of "why."

The Pitch (60 seconds)

Every other MCP browser tool ships a full browser binary. Playwright MCP? ~250MB. Puppeteer MCP? ~400MB. Chrome DevTools MCP? ~350MB.

bwb uses raw Chrome DevTools Protocol (CDP) — the same protocol Chrome speaks natively. It auto-detects the browser already on your system. No downloads. No binary mismatches. No "why is my disk full" panic.

Related MCP server: Browser Jet Pilot

🔥 The Features That Actually Matter

1. browser_act — Talk to the Browser Like a Human

browser_act({instruction: "search for laptops under a thousand dollars"})

No findElement hell. No chaining 10 calls. bwb parses what you want, finds the right elements, interacts, and returns the result. Pure DOM heuristics — no LLM dependency, no API costs, no "the AI is thinking..." spinner.

2. browser_watch — See What the Page Is Doing

This is the one feature nobody else has. Your agent can listen to the page:

browser_watch({action: "start", events: ["console", "network"]})
// ... do stuff ...
const events = browser_watch({action: "poll"})
// → [{type: "console", text: "React mounted"}, {type: "network", url: "https://api.example.com/data", status: 200}]

Console logs. Network requests. JS exceptions. Page navigations. Your agent isn't flying blind anymore.

3. "Login Once, Agent Works for Days"

// Monday: Login
browser_saveCookies({name: "gmail"})

// Wednesday: Still logged in. Fresh browser. Zero fuss.
browser_loadCookies({name: "gmail"})
browser_goto({url: "https://gmail.com"})  // Already authenticated

Sessions persist across agent restarts, server restarts, even across different machines.

4. browser_diagnose — Lighthouse for Your AI Agent

One call gets you: performance metrics, console errors, broken images, meta tags, interaction count, and a health score. Your agent can self-diagnose instead of guessing.

5. Multi-Tab & Sessions

Create tabs, close them, switch between them, save cookies, load them back. Like a real browser. Because it is one.

6. Realistic Browser Profile

Normalizes navigator.webdriver, plugins, languages, and user-agent for testing environments. Not "stealth mode" — just honest fingerprint normalization so your tests actually match real user conditions.

Quick Install

npm install -g bwb-browser
bwb --version
# → bwb-browser 3.1.1

Done. If you have Chrome/Chromium anywhere on your system, bwb finds it. No config files. No environment variables. Just works.

On Termux/Android:

pkg install chromium      # One-time
npm install -g bwb-browser
bwb

Yes, this runs on a phone. Yes, it's fully functional. Yes, I built it this way on purpose.

All 25 Tools

Where It Runs

MCP Agent Integration

Add this to any MCP-compatible agent's config:

{
  "mcpServers": {
    "bwb": {
      "command": "bwb"
    }
  }
}

Works with: Claude Code, OpenCode, Antigravity CLI, Cline, Continue.dev, Aider, Codex CLI, Cody, Windsurf, Cursor — literally anything that speaks MCP.

See AGENTS.md for copy-paste configs for each one.

The Backstory

I built this because I was tired of every browser automation tool assuming you have 400MB to spare and a desktop-class machine. I work from my phone sometimes. Termux exists. Why shouldn't browser automation work there too?

So I did what any reasonable person would do: I ignored all the existing solutions and wrote my own, using nothing but raw CDP — the protocol Chrome speaks natively. No wrappers. No abstractions. Just JSON messages over WebSocket.

The result is 76KB of source code that does what 400MB of dependencies do. It's not better code — it's less code. And sometimes less is all you need.

— Krish Tiwari (@krshforever), somewhere on an Indian train, writing code on a phone

Roadmap

• bwb Cloud — hosted browser instances so your agent has a browser even when your laptop's asleep

• browser_act v2 — multi-step with feedback loops (not just "search for X" but "research this topic and summarize")

• Recording & Replay — record sessions, replay them, debug them

• Browser pool — multiple isolated instances for CI parallelization

Support

If bwb saves you time, money, or a few brain cells:

• GitHub Sponsors

No gating. No "pro" tier. No bait-and-switch. The code is MIT forever. If you can't or won't pay, that's genuinely fine — I built this because I wanted it to exist.

License

MIT — Krish Tiwari (@krshforever)