Bwb Browser

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.

| Factor | bwb | Playwright MCP | Puppeteer MCP | |--------|-----|----------------|---------------| | Source size | 76KB | ~50MB+ | ~100MB+ | | Total install | ~1MB | ~250MB | ~400MB | | Bundled browser | None | Chromium (~200MB) | Chromium (~300MB) | | Works on Termux/Android | ✅ Yes | ❌ | ❌ | | Zero deps (no node_modules hell) | ✅ Yes | ❌ | ❌ | | Live event streaming | ✅ | ❌ | ❌ | | Natural language interaction | ✅ | ❌ | ❌ | | Persistent sessions | ✅ | ❌ | ❌ | | CPU profile at idle | Basically nothing | 🐌 | 🐌 |

---

🔥 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

| Tool | Description | |------|-------------| | browser_act | 🔥 Natural language — "search for X", "click the button", "what's on this page" | | browser_watch | 🔥 Live event capture — console, network, errors, navigation | | browser_diagnose | 🔥 Full page health check — perf, errors, broken images, score | | browser_fingerprint | 🔥 Realistic browser profile for testing | | browser_goto | Navigate to a URL | | browser_screenshot | Take a screenshot | | browser_html | Get page/selector HTML | | browser_text | Get page/selector text | | browser_title | Get page title | | browser_url | Get current URL | | browser_back | Go back in history | | browser_click | Click an element (native CDP) | | browser_fill | Fill an input field (native CDP) | | browser_elements | List interactive elements | | browser_eval | Execute JavaScript | | browser_setViewport | Change viewport size | | browser_waitForSelector | Wait for element to appear/disappear | | browser_newTab | Create new tab | | browser_closeTab | Close a tab | | browser_switchTab | Switch to a tab | | browser_listTabs | List all tabs | | browser_saveCookies | Save session to disk | | browser_loadCookies | Load session from disk | | browser_listSessions | List saved sessions | | browser_status | Browser connection info | | browser_restart | Restart the browser |

---

Where It Runs

| Platform | Status | Notes | |----------|--------|-------| | Termux/Android | ✅ Verified | pkg install chromium, that's it | | Linux | ✅ Verified | Auto-detects Chrome/Chromium | | macOS | ✅ Verified | Auto-detects Chrome.app | | Windows | ✅ Verified | Auto-detects Chrome.exe | | CI (GitHub Actions) | ✅ Verified | Uses system Chrome | | Docker | ✅ Verified | Just need Chrome in container | | Your Raspberry Pi | ✅ Why not | Same npm install |

---

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](./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)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: krshforever
• Source: krshforever/bwb-browser
• License: MIT
• Homepage: https://www.npmjs.com/package/bwb-browser

Install and usage instructions live in the source repository linked above.