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…

这是什么?BrowserOS 是一个单一代码仓库(monorepo),包含两款开源的 Chromium 分支浏览器:'BrowserOS neo',一款由你的 AI 智能体操控的辅助浏览器(通过 MCP 连接 Claude Code 或 Codex 等工具);以及 'BrowserOS',一款由你自己用 AI 智能体操作的浏览器,每个新标签页内都内置了 AI 智能体。
BrowserOS neo 和 BrowserOS 是同一款产品吗?不是,它们是来自同一代码仓库的两款独立浏览器。BrowserOS neo 是由 AI 驱动的浏览器(智能体在标签页中工作,你可以在旁观看或回放);而 BrowserOS 是由你自己操作的浏览器,内置了 AI 助手。两者可以同时运行。
我该如何让 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 适合哪些人?适合已经在使用 AI 编程智能体(如 Claude Code、Codex、Cursor 等)的用户,他们希望这些智能体能在已登录的真实网站上完成任务,比如订机票或管理社交媒体,而不是在空白的沙盒里工作。
支持哪些操作系统?两款浏览器都可以在 macOS、Windows 和 Linux 上运行(Linux 版本为 x64 架构,通过 AppImage 或 DEB 安装包提供)。
我的浏览数据会离开我的电脑吗?不会。会话、截图和历史记录都保存在本地的 ~/.browserclaw/ 目录下,从不上传;只会发送匿名且不含内容的使用事件(例如智能体的连接与断开、版本、操作系统),并且可以在设置中关闭。
这和直接用 Playwright 自动化控制 Chrome 有什么不同?Playwright 等无头浏览器驱动工具会启动一个全新的、未登录的 Chrome 子进程,这对持续集成(CI)很合适,但对需要你真实账号的任务毫无用处。BrowserOS neo 只需一次性导入你真实的 Chrome 登录信息,并在智能体的多次会话之间持续保留。
为什么不改用 browser-use 或 Browserbase 这类云端浏览器智能体?云端浏览器运行在数据中心里,登录个人账号很麻烦,而且 Twitter、LinkedIn 等网站常常会屏蔽数据中心的 IP。BrowserOS neo 在 127.0.0.1 本地运行,因此看起来和表现得就像你平时的家庭网络连接。
实时仪表盘和回放功能究竟能显示什么?每个新标签页都会变成一个实时视图,显示每个智能体当前正在做什么(网站、操作、进度);每次会话都会保存为可拖动进度条查看的本地视频,并附带逐步的操作时间线,方便你之后随时回看。
BrowserOS neo 比其他方案消耗更少的 AI token 吗?README 中说明,对于同一任务,BrowserOS neo 比 Claude 的 Chrome 扩展程序或 Codex 浏览器等替代方案消耗的 token 更少,这得益于专为网页操作打造的工具。
Size
205.2 MB
Stars
14K
Age
1y
Commits · 90 Days