BrowserOS README

The project's README from github.com/browseros-ai/BrowserOS. As one markdown file: README.md.

BrowserOS neo: the missing browser for your AI agents



Discord Slack X / Twitter GitHub stars AGPL-3.0

BrowserOS neo - The Missing Browser for Claude, Cowork & Codex | Product Hunt browseros-ai%2FBrowserOS | Trendshift

Download for macOS Download for Windows Download for Linux (x64 AppImage) Download for Linux (amd64 DEB)

Website · Docs · Enterprise

Free · Open source · Everything runs on your machine

A second browser, just for your AI agents. Import your logins from Chrome in one click, connect Claude Code, Codex, or any MCP agent, and hand off your web tasks. Agents run in parallel in their own tabs. You watch live, or replay any session like a video.

BrowserOS neo is not a Chrome replacement. It is a secondary browser that sits next to Chrome, made friendly to agents.

Get started

1. Install BrowserOS neo

brew tap browseros-ai/tap
brew install --cask browseros-neo

Prefer a direct download? Grab it for macOS, Windows, or Linux x64 (AppImage · DEB).

2. Import from Chrome

One click brings over your logins, bookmarks and extensions. Your agents work with your real accounts from the first task.

3. Connect your agent

BrowserOS neo finds Claude Code, Codex, Cursor, VS Code, OpenClaw and Hermes on your machine. Connect any of them with one click.

4. Give it a task

From your agent, not from the browser:

Book me the cheapest flight to London.

Watch it happen live in your new tab, or replay it later.

What can your agents do?

Anything that needs a logged-in browser:

Key features

Live dashboard

Your new tab shows every agent working right now: which site it's on, what it's doing, how far along. Docs 		BrowserOS neo dashboard showing agent sessions and recent activity

One-click connect

Automatically connects to every harness. We built tools optimized for web use! Docs 		BrowserOS neo MCP connect board with one-click install for supported AI tools

Replay every session

Every session is saved as a scrubbable video on your disk with a step-by-step action timeline. Rewind and see exactly what happened. Docs 		BrowserOS neo replay view with video scrubber and action timeline

Why BrowserOS neo over the alternatives?

Also in this repo: BrowserOS

BrowserOS, the AI browser for humans

A Chromium fork with an AI agent built into every new tab, for when you are the one browsing. Bring your own AI keys or run everything locally with Ollama.

Read about BrowserOS  ·  Website  ·  Docs

FAQ

What's the difference between BrowserOS neo and BrowserOS? BrowserOS neo is a browser your AI drives. BrowserOS is a browser you drive, with an AI agent built in. Both ship from this repo and run side by side. Keep your daily browser, and let agents work in neo.

Which AI tools work with BrowserOS neo? Any AI that speaks MCP. Claude Code, Codex, Cursor, VS Code, Zed, OpenCode, Hermes, OpenClaw and Antigravity connect with one click.

Does anything leave my machine? Your sessions, screenshots, history, and settings live under ~/.browserclaw/ and never upload. BrowserOS neo sends anonymous product-usage events (agent connect/disconnect, version, OS) to help us improve the app; it never sends URLs, page content, prompts, tool results, or screenshots. Off with one toggle in Settings. Full policy.

Do my Chrome extensions and bookmarks work? Yes. Both browsers are Chromium forks, so Chrome extensions work and your bookmarks, passwords, and settings import in one click.

What platforms are supported? BrowserOS neo and BrowserOS run on macOS, Windows, and Linux. Neo's Linux builds are x64. System requirements match Google Chrome.

Get help

For developers

Both browsers ship from this monorepo. Two main subsystems: the browser (Chromium fork, C++ and Python) and the agent platform (TypeScript and Rust).

Architecture

BrowserOS/
├── packages/browseros/              # Chromium fork + build system (Python)
│   ├── chromium_patches/            # Patches applied to Chromium source
│   ├── build/                       # Build CLI and modules
│   └── resources/                   # Icons, entitlements, signing
│
└── packages/browseros-agent/        # Agent platform (TypeScript / Rust)
    ├── apps/
    │   ├── claw-server/             # BrowserOS neo backend: MCP endpoint + JSON API (Rust)
    │   ├── claw-app/                # BrowserOS neo dashboard extension (WXT + React)
    │   ├── claw-onboard/            # BrowserOS neo onboarding flow (Vite)
    │   ├── server/                  # BrowserOS MCP server + AI agent loop (Bun)
    │   ├── app/                     # BrowserOS extension UI (WXT + React)
    │   └── app-onboard/             # BrowserOS onboarding flow (Vite)
    │
    ├── packages/                    # Shared TypeScript packages
    │   ├── acpx-ai-provider/        # AI SDK provider over the acpx ACP runtime
    │   ├── agent-mcp-manager/       # Add, link and unlink MCP servers across coding agents
    │   ├── browser-core/            # Core browser control primitives
    │   ├── browser-mcp/             # Browser MCP tool surface
    │   ├── build-server-tools/      # Shared build tooling for server binaries and assets
    │   ├── cdp-protocol/            # CDP type bindings
    │   ├── claw-api/                # Generated BrowserOS neo wire types
    │   ├── claw-api-client/         # Contract-typed BrowserOS neo HTTP client
    │   ├── onboarding-video/        # Remotion compositions for the first-run demo
    │   └── shared/                  # Shared constants
    │
    └── crates/                      # Shared Rust crates
        ├── browseros-cdp/           # CDP bindings
        ├── browseros-core/          # Core primitives
        ├── browseros-mcp/           # MCP server implementation
        ├── claw-api/                # Wire types, shared with the TypeScript package
        └── harness-integrations/    # Managed integrations for AI coding harnesses
Package What it does
packages/browseros Chromium fork: patches, build system, signing
apps/claw-server BrowserOS neo backend: MCP endpoint agents connect to, plus the API behind the dashboard
apps/claw-app BrowserOS neo new-tab dashboard: watch, replay, and manage agent sessions
apps/claw-onboard BrowserOS neo first-run onboarding
apps/server Bun server exposing the browser MCP tools and running the BrowserOS AI agent loop
apps/app BrowserOS extension: new tab, side panel chat, onboarding, settings
apps/app-onboard BrowserOS first-run onboarding

Contributing

We'd love your help making BrowserOS neo and BrowserOS better. Start with the Contributing Guide, which routes you to the right path.

Credits

Citation

If you use BrowserOS or BrowserOS neo in your research or project, please cite:

@software{browseros2025,
  author = {Nithin Sonti and Nikhil Sonti and {BrowserOS-team}},
  title = {BrowserOS: The open-source Agentic browser},
  url = {https://github.com/browseros-ai/BrowserOS},
  year = {2025},
  publisher = {GitHub},
  license = {AGPL-3.0},
}

License

BrowserOS neo and BrowserOS are open source under the AGPL-3.0 license.

Copyright © 2026 Felafax, Inc.

Watch the repo if you want to hear when agents can do something new.

Stargazers

Thank you to all our supporters.

Nikhil Nithin Dani
Follow Nikhil on X Follow Nithin on X Follow Dani on X

Built with ❤️ from San Francisco

BrowserOS (browseros-ai/BrowserOS)

Searching Database…

14K ·GitHub
BrowserOS
Что это такое?BrowserOS — монорепозиторий, в котором выпускаются два браузера на основе форков Chromium с открытым исходным кодом: «BrowserOS neo», вспомогательный браузер, которым управляют ваши ИИ-агенты (они подключаются по MCP к инструментам вроде Claude Code или Codex), и «BrowserOS», браузер, которым вы управляете сами, с ИИ-агентом, встроенным в каждую новую вкладку.
BrowserOS neo — это тот же продукт, что и BrowserOS?Нет, это два разных браузера из одного репозитория. BrowserOS neo — браузер, которым управляет ИИ: агенты работают во вкладках, а вы наблюдаете за ними или просматриваете их действия в записи. BrowserOS — браузер, которым управляете вы, со встроенным ИИ-ассистентом. Они могут работать одновременно.
Как запустить BrowserOS neo?Скачайте установщик для macOS, Windows или Linux x64 (AppImage или DEB), затем одним кликом импортируйте логины, закладки и расширения из Chrome и подключите агента, например Claude Code или Codex.
Каких ИИ-агентов для программирования можно подключить к BrowserOS neo?Любой агент с поддержкой MCP работает сразу: Claude Code, Codex, Cursor, VS Code, Zed, OpenCode, Hermes, OpenClaw и Antigravity подключаются одним кликом.
Есть ли при установке подводные камни, о которых мне стоит знать?Сборки для Linux пока только для x64, а аппаратные требования приложения совпадают с требованиями Google Chrome, поэтому на очень старых компьютерах могут возникнуть проблемы.
Для кого предназначен BrowserOS neo?Для тех, кто уже пользуется ИИ-агентами для программирования (Claude Code, Codex, Cursor и др.) и хочет, чтобы эти агенты выполняли реальные задачи на сайтах, где вы уже вошли в аккаунт, например бронировали авиабилеты или вели соцсети, а не работали в пустой изолированной среде.
Какие операционные системы поддерживаются?Оба браузера работают на macOS, Windows и Linux (сборки для Linux — x64, в виде пакетов AppImage или DEB).
Покидают ли мой компьютер какие-либо данные о моих просмотрах?Нет, сессии, скриншоты и история хранятся локально в ~/.browserclaw/ и никогда не загружаются. Отправляются только анонимные события без содержимого (например, подключение и отключение агента, версия, ОС), и их можно отключить в настройках.
Чем это отличается от простой автоматизации Chrome через Playwright?Playwright и похожие драйверы без графического интерфейса запускают новый процесс Chrome, в котором вы не вошли в аккаунты. Это подходит для CI, но бесполезно для задач, требующих ваших реальных аккаунтов. BrowserOS neo один раз импортирует ваши настоящие логины из Chrome и сохраняет их между сессиями агентов.
Почему бы вместо этого не использовать облачного браузерного агента, например browser-use или Browserbase?Облачные браузеры работают в дата-центре, поэтому входить в личные аккаунты неудобно, а такие сайты, как Twitter и LinkedIn, часто блокируют IP-адреса дата-центров. BrowserOS neo работает локально на 127.0.0.1, поэтому выглядит и ведёт себя как ваше обычное домашнее подключение.
Что на самом деле показывает функция живой панели и воспроизведения?Каждая новая вкладка превращается в живой просмотр того, что сейчас делает каждый агент (сайт, действие, прогресс). Каждая сессия сохраняется как локальное видео с возможностью перемотки и пошаговой временной шкалой действий, к которой можно вернуться позже.
Тратит ли BrowserOS neo меньше токенов ИИ, чем альтернативы?В README указано, что для одной и той же задачи BrowserOS neo расходует меньше токенов, чем альтернативы, например расширение Claude для Chrome или браузер Codex. Это связано с инструментами, созданными специально для работы с вебом.
What are similar projects?coral, davinci-resolve-mcp, headroom, wigolo, bb-browser, gemini-notebook-mcp-cli, brigade, mcp-for-blender
Which topics is it in?lmstudio, zed, chromium, bun, vscode, openclaw, opencode, browser-automation, model-context-protocol, ollama, agpl, cursor
Creator
browseros-ai
Size
205.2 MB
Stars
14K
Updated
CommitOct 16Releasebrowserclaw/v0.51.1.2Oct 13
Age
1y
Commits · 90 Days