Skip to main content
Glama
MOB3 Terminal Web Browser

MOB3 Terminal Web Browser

Official
by mob3net

MOB³ is a small indie web browser for the terminal

Written in Go, MOB³ features its own HTML rendering engine with JavaScript support, an ANSI renderer, and inline image support. No GUI toolkit or persistent browser profile required. Built as a true terminal web browser for humans and AI agents.

Project page: mob3.net

GitHub: github.com/mob3net/mob3

Documentation

Related MCP server: nascoder-terminal-browser-mcp

Try it with Docker:

docker run --rm -it ghcr.io/mob3net/mob3 -graphics blocks

Download and install

Download the latest MOB³ release from GitHub Releases.

Release archives cover Linux (386, amd64, armv6, armv7, arm64) and macOS (amd64, arm64). Choose the archive for your OS and architecture, for example mob3_vX.Y.Z_linux_amd64.tar.gz. Each archive contains the static mob3 binary.

Example:

tar -xzf mob3_vX.Y.Z_linux_amd64.tar.gz
sudo install -m 0755 mob3 /usr/local/bin/mob3
mob3 -version

Screenshots

Show your support

If MOB³ has been useful to you, please consider giving the project a star on GitHub. It helps others discover it and supports the continued development of the project.

What to expect

MOB³ is a content browser, not a full browser engine. It is happiest with text-focused pages and gets rough on modern JavaScript-heavy apps.

Works well

  • Documentation, blogs, news articles, wikis, forums, changelogs and old or server-rendered HTML.

  • Headings, paragraphs, lists, links, tables, <pre> blocks, images and common presentational markup.

  • Text/search inputs, textareas, single-select option popups and multi-select list boxes, with a visible caret, arrow-key editing, date/time/month/week, range sliders, color swatches, HTML constraint checks, GET and urlencoded POST form submission. The start page has justified text and a full-width search/URL box that resolves input the same way as the o prompt, including the -search fallback.

  • Common CSS: selectors, cascade and inheritance, box model (including box-sizing and min/max sizes), margins, borders, backgrounds, text styling, lists, tables, viewport-width @media queries and basic flex rows.

  • PNG/JPEG/GIF/WebP/BMP/SVG/data-URI images when enabled with -graphics (auto, kitty, iterm, or blocks for half-block art). Images are off by default for speed.

  • Session-only memory cache for CSS, scripts and decoded images, with a 32 MiB default budget and -cache to change or disable it.

  • Light JavaScript: DOM queries and mutation, classList/style, click handlers, timers, alert/confirm/prompt and native <dialog> open/close, same-origin fetch/XMLHttpRequest plus simple CORS cross-origin requests, and in-memory storage/cookies. Script errors turn the footer JavaScript label into a red JavaScript:Error; click it to open the console.

  • JavaScript console (!): tabbed view of logs, requests, cookies and in-memory storage, the raw page HTML, and a Tools tab for read-only page inspection (help, form, links, requests, logs, source, snapshot, history, clear); evaluate one-line expressions in the page's runtime, with Up/Down or Ctrl-P/Ctrl-N history and results appended to the log. clear/cls empties either the JS log or the Tools scrollback.

  • Reader mode (R, the footer Reader:on/Reader:off label, or -reader at launch): extracts the main article into a narrow, chrome-free text column, stays enabled across navigation, and restores the normal page and scroll position when toggled off.

  • Dark mode (D, the footer Dark:on/Dark:off label, or -dark at launch): asks sites for their dark styles with prefers-color-scheme: dark. Pages that already render a dark background keep their own palette; otherwise backgrounds, text, links and borders are remapped to a dark palette. Images keep their original colors.

  • Headless MCP automation (-mcp): navigate, snapshot page text and links, click links or elements by text, list and fill forms, select options, submit, wait for async content, type, press keys, scroll, evaluate JavaScript, inspect history and read request logs, JS errors or page source. Screen captures are terminal-cell rasters; sessions are memory-only.

  • Browser-style toolbar with back/forward/reload/home, history/help buttons, a bookmarks button when -bookmarks is supplied, a config gear and a centered page title.

  • Keyboard and mouse navigation, including the kitty keyboard protocol in kitty, WezTerm, Ghostty and foot, / incremental find (including multi-word phrases) with highlighted matches (also in the console HTML tab), a draggable page scrollbar, history (including a top-right History page listing the session's links), bookmarks imported with -bookmarks from a Netscape HTML export, scrolling, focus, link hover targets in the footer, text selection, and a ! JavaScript console.

Rough edges

  • Modern JavaScript apps (SPAs, dashboards, Google search and similar) may show a partial page, a blank page or their no-JavaScript fallback. Pages that rely on ES modules show a status-bar warning that modules are unsupported and suggest reader mode (R).

  • Reader mode is heuristic: it can pick too little or too much content on unusual layouts, shows a snapshot rather than live updates, and removes images, forms and other interactive controls. Dark mode keeps images in their original colors and approximates some author color schemes.

  • Anti-bot and firewall checks (Cloudflare, CAPTCHA, DataDome/PerimeterX, Imperva/Sucuri, access-denied pages) are generally not usable. A “Site blocked” page is shown instead.

  • No video/audio playback, WebGL, WebAssembly, workers, WebSockets, iframes, Shadow DOM, custom elements, real observers or full History API.

  • Basic CSS grid rows are supported, along with position:relative, position:absolute and position:fixed; floats, position:sticky, z-index, CSS variables, animations, transitions, generated content, @import and background images are unsupported or approximated as block flow.

  • SVG support is partial: text inside SVG, <use>/<symbol>, filters, masks and CSS-in-SVG may be missing. Animated WebP is not supported.

  • Oversized images are capped at 60% of the viewport width and 24 rows, preserving their aspect ratio.

  • No tabs or automatic downloads; download links and non-HTML responses open a popup with a copyable curl command instead, and multipart/file uploads are not implemented (clicking a file input shows an unsupported notice). Selected page text copies with y through OSC 52 (terminal support required), and the URL can be selected with the terminal.

  • Very large pages, stylesheets and images are capped to keep memory and CPU bounded. Style and layout also run under a time budget, so a pathological page is shown partially with a truncation notice instead of freezing the browser. Pages whose timers update the DOM are redrawn a few times per second rather than continuously, and an idle page with no pending timers does not repaint at all.

Using command line options

Start reading Wikipedia in dark mode:

mob3 -dark -reader 'https://en.wikipedia.org/wiki/Vim_(text_editor)'

See all available options with -h flag. Every flag and default is listed in the command-line reference.

Capture a PNG screenshot:

mob3 -png -width 120 bbc.com/news > bbc.png

Automation (MCP)

mob3 -mcp runs a headless browser as a Model Context Protocol server over stdin/stdout. It accepts an optional starting URL and fixed -width:

{
  "mcpServers": {
    "mob3": {
      "command": "/path/to/mob3",
      "args": ["-mcp", "-width", "100", "about:home"]
    }
  }
}

Tools: navigate, snapshot, screenshot, click (link number, CSS selector or x/y), type, press, scroll, back, forward, reload, evaluate and history. snapshot returns the current page viewport as text, visible links as [n] and form controls with coordinates. Results are text only: there is no pixel screenshot because MOB3 renders to terminal cells.

The server is local and unauthenticated, sessions and storage are memory-only, and nothing is written to disk. Do not expose it as a network service. See the full MCP reference for the protocol, snapshot format, tool details, and setup instructions for OpenCode, Claude Code, Cursor and Claude Desktop.

Development

Build from source and start browsing:

make
./bin/mob3 https://example.com

Requires Go 1.27 or newer. Interactive mode runs on Linux and macOS terminals; Windows users can run it under WSL. When stdin/stdout are not a terminal, MOB³ automatically falls back to dump mode.

Press ? inside the app for keys, mouse and forms help. Run mob3 -h for the full list of command-line flags. mob3 -version prints the embedded version.

Contributing

Contributions are welcome. Every pull request must include the broad license-grant CLA statement described in CONTRIBUTING.md; it keeps MOB³ available under both AGPL-3.0-only and a commercial license. The PR workflow checks the statement. The CI workflow runs formatting, vet and tests.

License

MOB³ is licensed under the GNU Affero General Public License, version 3 only (AGPL-3.0-only). Copyright (c) 2026 Milos Stojanovic. See LICENSE.

A separate commercial license is available on request for use without the AGPL's source-disclosure requirements.

MOB³ is provided “as is”, without warranty of any kind. See the warning at the top: this is not a security boundary.

Third-party module licenses are listed in THIRD_PARTY_NOTICES.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Interactive PTY sessions for AI agents — local shells, SSH with persistent sessions (ai-tmux daemon for attach/detach), and serial ports. Single Go binary, no tmux dependency.
      16
      20
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A semantic terminal browser that renders web pages as structured numbered elements for LLM agents via MCP, enabling agents to navigate, interact, and extract data from any website.
      9 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to fully control a terminal browser via MCP, navigating pages, filling forms, logging in, and managing cookies with deterministic numbered links and forms. Also provides an interactive human CLI.
      MIT