d79c2a4123
* feat: create GitHub release with changelog on agent-sdk publish After publishing to npm, the workflow now: - Tags the commit as agent-sdk-v<version> - Generates release notes from commits that modified the agent-sdk directory since the last agent-sdk release tag - Creates a GitHub release with those notes First release will show "Initial release" since no previous tag exists. * feat: update CHANGELOG.md on agent-sdk release Add a CHANGELOG.md for @browseros-ai/agent-sdk and update the release workflow to prepend a versioned entry with the release notes before creating the GitHub release. The changelog is committed to main automatically. * fix: address review issues in agent-sdk release workflow - Add explicit permissions: contents: write - Replace sed with head/tail for safe CHANGELOG insertion (fixes double-quote and backslash corruption in commit messages) - Handle empty release notes with "No notable changes." fallback - Make git tag idempotent for workflow reruns (2>/dev/null || true) * fix: use PR with auto-merge for changelog updates Direct push to main fails due to branch protection requiring PRs. Instead, create a branch, open a PR, and auto-merge via squash. * feat: add contributors and PR links to agent-sdk release notes Release notes now include PR numbers (linked automatically by GitHub), GitHub usernames for each commit author, and a contributors section at the bottom. All scoped to commits that modified the agent-sdk path. * fix: reorder release steps and fix tag/idempotency issues - Capture release SHA before any branching so the tag always points to the main commit that was built and published to npm - Reorder: generate notes → publish → tag/release → changelog PR (changelog is lowest-stakes, runs last) - Make tag push and release create idempotent for safe re-runs (fall back to gh release edit if release already exists) - Add || true to gh pr merge --auto in case auto-merge is not enabled - Explicit git checkout main before creating changelog branch * fix: explicit error handling for tag/release and contributor dedup - Replace silent || true guards with explicit checks that log what's happening (tag exists, remote tag exists, release exists) so errors are visible instead of swallowed - Fix contributor dedup: use grep -qw (word match) instead of grep -qF (substring match) so "dan" isn't excluded when "dansmith" exists * fix: exclude current version tag when finding previous release On re-runs, the current version's tag already exists on the remote, so PREV_TAG resolves to it and git log produces empty output. Filter it out so release notes are generated against the actual previous version. * ci: prevent concurrent agent-sdk release runs Add concurrency group so multiple dispatches queue instead of racing on the same tag/release/PR.
🌐 BrowserOS is an open-source Chromium fork that runs AI agents natively. The privacy-first alternative to ChatGPT Atlas, Perplexity Comet, and Dia.
🔒 Use your own API keys or run local models with Ollama. Your data never leaves your machine.
💡 Join our Discord or Slack and help us build! Have feature requests? Suggest here.
Quick start
-
Download and install BrowserOS:
-
Import your Chrome data (optional)
-
Connect your AI provider — use Claude, OpenAI, Gemini, or local models via Ollama and LMStudio.
-
Start automating!
What makes BrowserOS special
- 🏠 Feels like home — same Chrome interface, all your extensions just work
- 🤖 AI agents that run on YOUR browser, not in the cloud
- 🔒 Privacy first — bring your own keys or run local models with Ollama. Your browsing history stays on your machine
- 🤝 BrowserOS as MCP server — control the browser from
claude-code,gemini-cli, or any MCP client (31 tools) - 🔄 Workflows — build repeatable browser automations with a visual graph builder
- 📂 Cowork — combine browser automation with local file operations. Research the web, save reports to your folder
- ⏰ Scheduled Tasks — run the agent on autopilot, daily or every few minutes
- 💬 LLM Hub — compare Claude, ChatGPT, and Gemini side-by-side on any page
- 🛡️ Built-in ad blocker — 10x more protection than Chrome with uBlock Origin + Manifest V2 support
- 🚀 100% open source under AGPL-3.0
Demos
🤖 BrowserOS agent in action
🎇 Install BrowserOS as MCP and control it from claude-code
https://github.com/user-attachments/assets/c725d6df-1a0d-40eb-a125-ea009bf664dc
💬 Use BrowserOS to chat
https://github.com/user-attachments/assets/726803c5-8e36-420e-8694-c63a2607beca
⚡ Use BrowserOS to scrape data
https://github.com/user-attachments/assets/9f038216-bc24-4555-abf1-af2adcb7ebc0
Why We're Building BrowserOS
For the first time since Netscape pioneered the web in 1994, AI gives us the chance to completely reimagine the browser. We've seen tools like Cursor deliver 10x productivity gains for developers—yet everyday browsing remains frustratingly archaic.
You're likely juggling 70+ tabs, battling your browser instead of having it assist you. Routine tasks, like ordering something from amazon or filling a form should be handled seamlessly by AI agents.
At BrowserOS, we're convinced that AI should empower you by automating tasks locally and securely—keeping your data private. We are building the best browser for this future!
How we compare
vs Chrome
While we're grateful for Google open-sourcing Chromium, but Chrome hasn't evolved much in 10 years. No AI features, no automation, no MCP support.
vs Brave
We love what Brave started, but they've spread themselves too thin with crypto, search, VPNs. We're laser-focused on AI-powered browsing.
vs Arc/Dia
Many loved Arc, but it was closed source. When they abandoned users, there was no recourse. We're 100% open source - fork it anytime!
vs Perplexity Comet
They're a search/ad company. Your browser history becomes their product. We keep everything local.
vs ChatGPT Atlas
Your browsing data could be used for ads or to train their models. We keep your history and agent interactions strictly local.
Contributing
We'd love your help making BrowserOS better!
License
BrowserOS is open source under the AGPL-3.0 license.
Credits
- ungoogled-chromium - BrowserOS uses some patches for enhanced privacy. Thanks to everyone behind this project!
- The Chromium Project - At the core of BrowserOS, making it possible to exist in the first place.
Citation
If you use BrowserOS in your research or project, please cite:
@software{browseros2025,
author = {Sonti, Nithin and Sonti, Nikhil 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},
}
Copyright © 2025 Felafax, Inc.
Stargazers
Thank you to all our supporters!
Built with ❤️ from San Francisco