From b3d4d668b46e0cd89e57a68b56f8a7adca295d8d Mon Sep 17 00:00:00 2001
From: Felarof <nithin.sonti@gmail.com>
Date: Thu, 15 Jan 2026 15:37:09 -0800
Subject: [PATCH] docs: add changelog page (#322)

Add a changelog page documenting BrowserOS releases from v0.30.0 to v0.36.2.
Each version includes date and summary of changes, with links to GitHub
releases for full history.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/changelog.mdx | 90 ++++++++++++++++++++++++++++++++++++++++++++++
 docs/docs.json     |  3 +-
 2 files changed, 92 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog.mdx

diff --git a/docs/changelog.mdx b/docs/changelog.mdx
new file mode 100644
index 000000000..de293084b
--- /dev/null
+++ b/docs/changelog.mdx
@@ -0,0 +1,90 @@
+---
+title: "Changelog"
+description: "What's new in BrowserOS"
+---
+
+All notable changes to BrowserOS are documented here. For the full release history with download links, see our [GitHub Releases](https://github.com/browseros-ai/BrowserOS/releases).
+
+---
+
+## v0.36.2
+<sub>January 10, 2026</sub>
+
+Bug fix release focused on MCP stability.
+
+- **MCP server disconnect fix** — Fixed port handling issue causing MCP connections to drop unexpectedly
+
+---
+
+## v0.36.0
+<sub>January 8, 2026</sub>
+
+- **Agent personalization** — Add your own prompts to personalize the agent. Tweak its behavior, adjust how it responds, set your preferred formatting, and more
+- **Toolbar customization** — Hide the Hub chat and labels from the settings page to declutter your toolbar
+- **MCP server port stability** — The port now stays consistent through browser restarts, so you don't have to keep updating your MCP clients
+- **Fixed agent install/update issues** — The agent now handles installs and updates more proactively
+
+---
+
+## v0.35.0
+<sub>December 25, 2025</sub>
+
+- **Agent stability fixes** — Fixed bugs to make the agent loop much more reliable
+- **Gemini 3 support** — Gemini 3 now supported through OpenRouter and Google adapters
+- **Better error surfacing** — Error messages are now clearer
+
+---
+
+## v0.34.0
+<sub>December 20, 2025</sub>
+
+- **Third-party MCP server support** — Connect external MCP servers like Google Calendar, Notion, Google Docs, Gmail, and more. You can also connect your own custom MCP servers
+- **Gemini 3 support** — Gemini 3 Pro and Flash models now work with BrowserOS
+- **Windows icon fix** — The Windows icon now displays BrowserOS logo correctly
+- **Agent & UI improvements** — Various agent loop fixes and UI polish
+
+---
+
+## v0.33.0
+<sub>December 18, 2025</sub>
+
+- **OpenAI-compatible provider support** — Connect any OpenAI-compatible API endpoint
+- **Multi-window & multi-profile agent support** — Agent now works across multiple windows and browser profiles
+- **MCP server reliability** — Fixed connection drops and improved stability
+- **Agent reliability improvements** — General stability fixes
+
+---
+
+## v0.32.0
+<sub>December 12, 2025</sub>
+
+A complete revamp of BrowserOS.
+
+**New features:**
+- **New Agent** — Completely rebuilt agent: faster, smarter, and more reliable
+- **Agent Per Tab** — Run multiple agents in different tabs simultaneously
+- **Polished UI** — Fresh, cleaner interface design
+- **Manifest V2 Support** — Ad blockers like uBlock Origin work again
+- **Native Split View** — Work on two things side by side
+- **Chromium 142** — Updated to Chromium 142.0.7444.49
+- **Azure & AWS Bedrock** — Native support for Azure OpenAI and AWS Bedrock models
+
+**Breaking changes:**
+- Old agent will stop working — update required
+- LLM provider settings won't carry over — reconfiguration needed
+
+---
+
+## v0.30.0
+<sub>November 14, 2025</sub>
+
+- **Better text extraction** — Improved copy button in LLM Chat
+- **MCP server stability** — Improved connection reliability
+- **UI cleanup** — Unpinned extensions for cleaner look
+- **Third-party MCP fixes** — Fixed support for third-party MCP servers
+
+---
+
+<Note>
+For older releases, see the [full release history on GitHub](https://github.com/browseros-ai/BrowserOS/releases).
+</Note>
diff --git a/docs/docs.json b/docs/docs.json
index c24f7df2f..33e04f190 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -15,7 +15,8 @@
         "pages": [
           "index",
           "onboarding",
-          "update"
+          "update",
+          "changelog"
         ]
       },
       {