diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 490bc17e0..d9fbfcc7b 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -16,11 +16,11 @@ All notable changes to BrowserOS are documented here. For the full release histo
- **Chromium 146** — Updated to the latest Chromium release with all recent upstream fixes and security patches
-
+
-
+
---
@@ -53,7 +53,7 @@ All notable changes to BrowserOS are documented here. For the full release histo
- **Keyboard shortcuts** — Updated shortcuts to avoid conflicts with European keyboards
-
+
---
@@ -87,9 +87,9 @@ Bug fix and stability release.
- **Agent history** — Agent conversations are now saved automatically. View and resume them anytime from the Assistant panel
-
+
-
+
---
diff --git a/docs/changelog/0.39.0-sync-mcp.png b/docs/changelog/0.39.0-sync-mcp.png
new file mode 100644
index 000000000..e68bf8d03
Binary files /dev/null and b/docs/changelog/0.39.0-sync-mcp.png differ
diff --git a/docs/changelog/agent-history-example.png b/docs/changelog/agent-history-example.png
new file mode 100644
index 000000000..5d6de8924
Binary files /dev/null and b/docs/changelog/agent-history-example.png differ
diff --git a/docs/changelog/agent-history-highlight.png b/docs/changelog/agent-history-highlight.png
new file mode 100644
index 000000000..de8dafe56
Binary files /dev/null and b/docs/changelog/agent-history-highlight.png differ
diff --git a/docs/changelog/soul-memory.png b/docs/changelog/soul-memory.png
new file mode 100644
index 000000000..59783043d
Binary files /dev/null and b/docs/changelog/soul-memory.png differ
diff --git a/docs/changelog/vertical-tabs.png b/docs/changelog/vertical-tabs.png
new file mode 100644
index 000000000..c6db9934c
Binary files /dev/null and b/docs/changelog/vertical-tabs.png differ
diff --git a/docs/contributing.mdx b/docs/contributing.mdx
index d1f860bed..df78663b6 100644
--- a/docs/contributing.mdx
+++ b/docs/contributing.mdx
@@ -38,7 +38,7 @@ The Agent is a monorepo with 3 components:
### Architecture
-
+
### Setup
diff --git a/docs/contributing/architecture.png b/docs/contributing/architecture.png
new file mode 100644
index 000000000..690b1a716
Binary files /dev/null and b/docs/contributing/architecture.png differ
diff --git a/docs/features/ad-blocking.mdx b/docs/features/ad-blocking.mdx
index 5d9c7ad86..a5ef2b5df 100644
--- a/docs/features/ad-blocking.mdx
+++ b/docs/features/ad-blocking.mdx
@@ -17,10 +17,10 @@ We ran both browsers through [adblock.turtlecute.org](https://adblock.turtlecute
+
+
*/}
+{/*
*/}
BrowserOS has partnered with [Moonshot AI](https://www.kimi.com) to bring **Kimi K2.5** as a first-class provider. Kimi K2.5 is now the **recommended model** in BrowserOS and is set as the default provider.
@@ -91,7 +91,7 @@ Connect to powerful AI models using your API keys. Your keys stay on your machin
2. Click **Get API key** in the sidebar
3. Click **Create API key** and copy it
- 
+ 
**Add to BrowserOS:**
1. Go to `chrome://browseros/settings`
@@ -101,7 +101,7 @@ Connect to powerful AI models using your API keys. Your keys stay on your machin
5. Check **Supports Images**, set **Context Window** to `1000000`
6. Click **Save**
- 
+ 
+
*/}
See [Smart Nudges](/features/smart-nudges#app-connection) for more details on how connection suggestions work.
@@ -59,7 +59,7 @@ You can also connect apps ahead of time from the sidebar if you prefer.
-
+
## 40+ Supported Apps
diff --git a/docs/features/llm-chat-hub.mdx b/docs/features/llm-chat-hub.mdx
index 2fe94e377..3601c0435 100644
--- a/docs/features/llm-chat-hub.mdx
+++ b/docs/features/llm-chat-hub.mdx
@@ -17,7 +17,7 @@ Watch the chat panel and LLM Hub in action:
Click the **Chat** button in the toolbar (or press `Option+K`) to open an AI chat panel on any webpage.
-
+
### Features
@@ -28,7 +28,7 @@ Click the **Chat** button in the toolbar (or press `Option+K`) to open an AI cha
### Toolbar Buttons
-
+
| Icon | Action |
|------|--------|
@@ -49,7 +49,7 @@ Click the **Chat** button in the toolbar (or press `Option+K`) to open an AI cha
Click the **Hub** button in the toolbar (or press `Cmd+Shift+U`) to open a multi-pane comparison window.
-
+
The Hub lets you query multiple LLMs simultaneously:
diff --git a/docs/features/llm-chat-panel.png b/docs/features/llm-chat-panel.png
new file mode 100644
index 000000000..9792e80f5
Binary files /dev/null and b/docs/features/llm-chat-panel.png differ
diff --git a/docs/features/llm-chat-toolbar.png b/docs/features/llm-chat-toolbar.png
new file mode 100644
index 000000000..a05bf3175
Binary files /dev/null and b/docs/features/llm-chat-toolbar.png differ
diff --git a/docs/features/llm-hub.png b/docs/features/llm-hub.png
new file mode 100644
index 000000000..976356aac
Binary files /dev/null and b/docs/features/llm-hub.png differ
diff --git a/docs/features/local-models.mdx b/docs/features/local-models.mdx
index bf358b99d..34897e6dd 100644
--- a/docs/features/local-models.mdx
+++ b/docs/features/local-models.mdx
@@ -50,7 +50,7 @@ Increasing context length uses more VRAM. Run `ollama ps` to check your current
4. Set **Context Window** to `20000`
5. Click **Save**
- 
+ 
@@ -64,7 +64,7 @@ Increasing context length uses more VRAM. Run `ollama ps` to check your current
+
## Schedule Types
@@ -95,11 +95,11 @@ When a scheduled task runs, you can see the results in two places:
- **New Tab page**: Results show up right on your new tab
- **Scheduled Tasks page**: View the full run history for each task
-
+
Each task keeps a history of its last 15 runs. Click on any run to see the full output, including what tools the agent used and what it found.
-
+
You can also:
- **Test** a task manually without waiting for the next scheduled run
diff --git a/docs/features/soul.mdx b/docs/features/soul.mdx
index 20ad79c9d..ac46e687f 100644
--- a/docs/features/soul.mdx
+++ b/docs/features/soul.mdx
@@ -42,7 +42,7 @@ You do not need to write or edit SOUL.md yourself. The assistant handles it. But
Open **Agent Soul** from the sidebar to see what your assistant's personality file looks like right now. The page shows the current contents of SOUL.md in a read-only viewer.
{/*
-
+
*/}
## Shaping Your Assistant
diff --git a/docs/features/use-with-claude-code.mdx b/docs/features/use-with-claude-code.mdx
index 25d000819..9a323f39a 100644
--- a/docs/features/use-with-claude-code.mdx
+++ b/docs/features/use-with-claude-code.mdx
@@ -45,7 +45,7 @@ Wondering how BrowserOS MCP compares to Chrome DevTools MCP or other browser aut
+
+
To switch back, return to the same setting and turn the toggle off. Your tabs move back to the horizontal strip instantly.
diff --git a/docs/hero-dark.png b/docs/hero-dark.png
new file mode 100644
index 000000000..d9a9e6516
Binary files /dev/null and b/docs/hero-dark.png differ
diff --git a/docs/images/about-browseros.png b/docs/images/about-browseros.png
deleted file mode 100644
index d1717e5f6..000000000
--- a/docs/images/about-browseros.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1ea0c549ef8c15de03bca70e8f56d2f2b29304694abb99e90122f8c74ad51a6f
-size 309038
diff --git a/docs/images/adblock-browseros.png b/docs/images/adblock-browseros.png
deleted file mode 100644
index c4c583870..000000000
--- a/docs/images/adblock-browseros.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:af6c75ef169be8340296b8bfadcbd46e0077271ad41acbf6aeeb2598ce691b16
-size 863630
diff --git a/docs/images/adblock-chrome.png b/docs/images/adblock-chrome.png
deleted file mode 100644
index 925ce2c4a..000000000
--- a/docs/images/adblock-chrome.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:eae2e9ff5797b4791f5171a6faa989c58d408dc1ff085b61879b12fab67f63dc
-size 913944
diff --git a/docs/images/browseros-mcp-turned-on.png b/docs/images/browseros-mcp-turned-on.png
deleted file mode 100644
index 6b957b417..000000000
--- a/docs/images/browseros-mcp-turned-on.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:434485e5eb780a049a4928d4a1b4be49dfc319b71d03c836c2e074df9981fa90
-size 142169
diff --git a/docs/images/byollm--claude-provider-config.png b/docs/images/byollm--claude-provider-config.png
deleted file mode 100644
index 172fdc085..000000000
--- a/docs/images/byollm--claude-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:16555bdfa08c5e905e2363073104ad09a02cf8ea071f95453fa153ad79a77242
-size 4763371
diff --git a/docs/images/byollm--gemini-provider-config.png b/docs/images/byollm--gemini-provider-config.png
deleted file mode 100644
index 6f1410043..000000000
--- a/docs/images/byollm--gemini-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:49dddd13cf0323d3cbe28a2cd8fc14fe305c21ac191dcb676abc93a916afb6ce
-size 4537801
diff --git a/docs/images/byollm--gemini-settings-card.png b/docs/images/byollm--gemini-settings-card.png
deleted file mode 100644
index 17980d06d..000000000
--- a/docs/images/byollm--gemini-settings-card.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:d860591dbd308f5c7c1a3e774d186ab302b5aa93d3c43763e5595412bbb0c1e6
-size 4756097
diff --git a/docs/images/byollm--lmstudio-config.png b/docs/images/byollm--lmstudio-config.png
deleted file mode 100644
index ed16f58e9..000000000
--- a/docs/images/byollm--lmstudio-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:ef1b96c9439bd5833a1be8dcfd83d2a1f7aee34cf8fddd37ab65c6c6c0324668
-size 4992844
diff --git a/docs/images/byollm--ollama-config.png b/docs/images/byollm--ollama-config.png
deleted file mode 100644
index 55798a953..000000000
--- a/docs/images/byollm--ollama-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:bec7c30055ac62a14a526a9f1fde47d54fdfa22b1fc1caee42393131ce56e56f
-size 4776402
diff --git a/docs/images/byollm--openai-provider-config.png b/docs/images/byollm--openai-provider-config.png
deleted file mode 100644
index fa62d33d3..000000000
--- a/docs/images/byollm--openai-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:ced4e6a2bcd107207d03fc8dc874f315e257e4b87cb28d17f6c32cba48c31f88
-size 5050714
diff --git a/docs/images/byollm--openrouter-provider-config.png b/docs/images/byollm--openrouter-provider-config.png
deleted file mode 100644
index 2c9987424..000000000
--- a/docs/images/byollm--openrouter-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:a5b5b536f6b54a38d0e3d3e36a73963a005a7d65a09f1fa13449bde52a86763d
-size 4759471
diff --git a/docs/images/byollm--switcher.png b/docs/images/byollm--switcher.png
deleted file mode 100644
index e1dccded6..000000000
--- a/docs/images/byollm--switcher.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:c717a2f507797eed79438620aebdaeb3743dc7ae984561756c91fe0f531aa846
-size 6696779
diff --git a/docs/images/changelog/0.36.3/agent-history-example.png b/docs/images/changelog/0.36.3/agent-history-example.png
deleted file mode 100644
index 867e493d4..000000000
--- a/docs/images/changelog/0.36.3/agent-history-example.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:a05446cf4561d0b79b7ba2bb3d494395560912dc76b1d7fa952a0a67827eb4c3
-size 508232
diff --git a/docs/images/changelog/0.36.3/agent-history-highlight.png b/docs/images/changelog/0.36.3/agent-history-highlight.png
deleted file mode 100644
index fe6cc7e33..000000000
--- a/docs/images/changelog/0.36.3/agent-history-highlight.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:90a8949f388e4dfc6a77c5dffd9c668fe8937c72cbc2e5a8892ff09117781253
-size 537711
diff --git a/docs/images/changelog/0.39.0-sync-mcp.png b/docs/images/changelog/0.39.0-sync-mcp.png
deleted file mode 100644
index 922f59422..000000000
--- a/docs/images/changelog/0.39.0-sync-mcp.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:4e7d847406fe553f0efd86d765912cb27730dd4e4884f61ec85ac81ad9a9a7f0
-size 575301
diff --git a/docs/images/changelog/0.42.0/soul-memory.png b/docs/images/changelog/0.42.0/soul-memory.png
deleted file mode 100644
index 78514a175..000000000
--- a/docs/images/changelog/0.42.0/soul-memory.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1ea3ac3db5958d69deafcd84ddd0e1c2ca39d57f5eed28333aa3ccf9a2799e90
-size 719360
diff --git a/docs/images/changelog/0.42.0/vertical-tabs.png b/docs/images/changelog/0.42.0/vertical-tabs.png
deleted file mode 100644
index 67743e0d4..000000000
--- a/docs/images/changelog/0.42.0/vertical-tabs.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:d139c824e9d77c1cd3763a78591a04af0686f0386f1a5712f9f5bfe4ad57cb9e
-size 368935
diff --git a/docs/images/check-for-updates.png b/docs/images/check-for-updates.png
deleted file mode 100644
index ded09aa65..000000000
--- a/docs/images/check-for-updates.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:4c3f857c6cacb1645ad4f051f5e76e0e55d4a0ca5bd63d6c565eb663bd553eb1
-size 467304
diff --git a/docs/images/checks-passed.png b/docs/images/checks-passed.png
deleted file mode 100644
index 97603943d..000000000
--- a/docs/images/checks-passed.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:93add382731d1e6d443b128bbe1ac747b62d0efa1b8372ee3fcd37a59d86da30
-size 160724
diff --git a/docs/images/claude-api-keys.png b/docs/images/claude-api-keys.png
deleted file mode 100644
index 8eac2f04c..000000000
--- a/docs/images/claude-api-keys.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:9edfd8b03a46f9078541bff55a0fa4d77e857ee02b26432fc448f6e16be2bd8f
-size 133514
diff --git a/docs/images/claude-create-key.png b/docs/images/claude-create-key.png
deleted file mode 100644
index 78298654f..000000000
--- a/docs/images/claude-create-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:a4e7285a4a2c02b1be2062d231ffe71a2e2d675648a8864c44b2f3a569a75632
-size 195296
diff --git a/docs/images/claude-provider-config.png b/docs/images/claude-provider-config.png
deleted file mode 100644
index 390ec3169..000000000
--- a/docs/images/claude-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:8145a0df6dc588de127824f3a808337be7c8b4bd6d32578f5218f01d24c0bebf
-size 102624
diff --git a/docs/images/connect-apps-query.png b/docs/images/connect-apps-query.png
deleted file mode 100644
index ca1fa7f11..000000000
--- a/docs/images/connect-apps-query.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:9210550eacfb2f9cd06cae3c54f714c3d40d8dcc80502c0964e391a6d7be52c0
-size 617998
diff --git a/docs/images/connect-apps-settings.png b/docs/images/connect-apps-settings.png
deleted file mode 100644
index 892f6906f..000000000
--- a/docs/images/connect-apps-settings.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:0f04cf8b1a43d7c20edb201a6f15a14b096f47e71e16b86f381421544fa94318
-size 426347
diff --git a/docs/images/contributing--architecture.png b/docs/images/contributing--architecture.png
deleted file mode 100644
index 9531e9b34..000000000
--- a/docs/images/contributing--architecture.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:59c78fa8b3696cc7e6799e90e6d744646a65ca4209b9e3fdddb2ab0e1e344029
-size 873000
diff --git a/docs/images/enable-mcp-server.png b/docs/images/enable-mcp-server.png
deleted file mode 100644
index 9c1b68892..000000000
--- a/docs/images/enable-mcp-server.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:84ede093b431990962219a92a73f659d35e33b56df61bcd62967d3c03229412f
-size 104597
diff --git a/docs/images/features--browseros-mcp-settings.png b/docs/images/features--browseros-mcp-settings.png
deleted file mode 100644
index 12e228263..000000000
--- a/docs/images/features--browseros-mcp-settings.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:4b56bf0f3b9d029f2f020a4a255250c7c85b97eea9d98b4402f46fe350d0ea6b
-size 4448586
diff --git a/docs/images/features--llm-chat-panel.png b/docs/images/features--llm-chat-panel.png
deleted file mode 100644
index 54e741f5a..000000000
--- a/docs/images/features--llm-chat-panel.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:254133b8dd71d580532071cee6a79db071b6e10ac2f12a6cd228a68469ca5ee8
-size 5134348
diff --git a/docs/images/features--llm-chat-toolbar.png b/docs/images/features--llm-chat-toolbar.png
deleted file mode 100644
index 0f892b4c6..000000000
--- a/docs/images/features--llm-chat-toolbar.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:30fd40d1e890922ff1838843089cbe497f0661d9f06720783311a32a09d0fca7
-size 2616706
diff --git a/docs/images/features--llm-hub.png b/docs/images/features--llm-hub.png
deleted file mode 100644
index 9ea0f5cb0..000000000
--- a/docs/images/features--llm-hub.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1ff7261a7a0a8583fc33936f5cdcfcfaee05fcf870d08ad96a8fb635185f7096
-size 4147338
diff --git a/docs/images/features--scheduled-tasks-create.png b/docs/images/features--scheduled-tasks-create.png
deleted file mode 100644
index e86178b39..000000000
--- a/docs/images/features--scheduled-tasks-create.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:62047e65722bb8864fc25d16a03a76f9b3ba7fb5d79d39dc834b5d3fc78252dc
-size 2626804
diff --git a/docs/images/features--scheduled-tasks-output.png b/docs/images/features--scheduled-tasks-output.png
deleted file mode 100644
index e4ec5d58e..000000000
--- a/docs/images/features--scheduled-tasks-output.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:85605f45061b62f3f0da7ba464cae3e36939c0d90655c44982c54379c24b452f
-size 3886284
diff --git a/docs/images/features--scheduled-tasks-results.png b/docs/images/features--scheduled-tasks-results.png
deleted file mode 100644
index e0463706c..000000000
--- a/docs/images/features--scheduled-tasks-results.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:e80726cdcc6136055e62ab804d876bd4338e97f16ce70de719a9ba932e47022f
-size 2643981
diff --git a/docs/images/features--vertical-tabs-setting.png b/docs/images/features--vertical-tabs-setting.png
deleted file mode 100644
index d9a33c9f0..000000000
--- a/docs/images/features--vertical-tabs-setting.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:4875e3c98a1f7584e94a2a412908f982b7903946c0ff7f67cba1e9cf74ce7b93
-size 240299
diff --git a/docs/images/gemini-copy-key.png b/docs/images/gemini-copy-key.png
deleted file mode 100644
index cd6efe26f..000000000
--- a/docs/images/gemini-copy-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:9a998b6d4db0f2af73738e31060d53abee5ae4dca4b4f7e818dabca51949507b
-size 187841
diff --git a/docs/images/gemini-create-key.png b/docs/images/gemini-create-key.png
deleted file mode 100644
index 2570365dc..000000000
--- a/docs/images/gemini-create-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:5b6b992a3ec90232a480dcb4cc44a66a13ae8af42b2ea52a90966d796ab0c0c4
-size 231884
diff --git a/docs/images/gemini-get-api-key.png b/docs/images/gemini-get-api-key.png
deleted file mode 100644
index 4a5b049f8..000000000
--- a/docs/images/gemini-get-api-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:d027f5423e7f37f0ac047ce6cd28a74224dba30c985b1bd60a1aa055589d590c
-size 226131
diff --git a/docs/images/gemini-provider-config.png b/docs/images/gemini-provider-config.png
deleted file mode 100644
index 71875183a..000000000
--- a/docs/images/gemini-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:51f5e0f4b0b7bc5d118e5a5d7ff0e075304e1186de9a8a3f988426fbb87f3829
-size 263317
diff --git a/docs/images/gemini-settings-card.png b/docs/images/gemini-settings-card.png
deleted file mode 100644
index 8fdeabdce..000000000
--- a/docs/images/gemini-settings-card.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:ba5c90b18235d67ab967ad8f7abc5e7d483583d2e316581fe6e2ebc7e4b5fc6c
-size 192851
diff --git a/docs/images/hero-dark.png b/docs/images/hero-dark.png
deleted file mode 100644
index fb101f20b..000000000
--- a/docs/images/hero-dark.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:87eea528b0c82018911e3ebf7bee294632714e1bd10691a7fd33fbc49e5c5bd7
-size 2556918
diff --git a/docs/images/hero-light.png b/docs/images/hero-light.png
deleted file mode 100644
index b72ce28ca..000000000
--- a/docs/images/hero-light.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:41a7a3663ae3226dc0838af887963f143c3554d891781ec5c7c0f6e7c5fb0b32
-size 104264
diff --git a/docs/images/mcp-click-on-settings-icon.png b/docs/images/mcp-click-on-settings-icon.png
deleted file mode 100644
index 00607ded4..000000000
--- a/docs/images/mcp-click-on-settings-icon.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:b4cb4e7ff2560a352ff5bc538efaa4c95618176eb49bc80a46dfe68ed436abc2
-size 102712
diff --git a/docs/images/mcp-note-down-the-port.png b/docs/images/mcp-note-down-the-port.png
deleted file mode 100644
index 6bf1e8af1..000000000
--- a/docs/images/mcp-note-down-the-port.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:92f114bc81fd2d282a7ea739b575cc6997ecdf2d5b35a563cab45b3e405a4ba0
-size 125082
diff --git a/docs/images/n8n-node.png b/docs/images/n8n-node.png
deleted file mode 100644
index 9dec4c4fb..000000000
--- a/docs/images/n8n-node.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:3d1ef4d3afadbbecdc6464a6dac65148bda2ea8e19f387a1c576c95d81199a95
-size 15765
diff --git a/docs/images/n8n-step3-workflow.png b/docs/images/n8n-step3-workflow.png
deleted file mode 100644
index 60a4ab5ca..000000000
--- a/docs/images/n8n-step3-workflow.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:ba22624c9b831c14d1ddefebdbcfedf5949a336486577df9d97c6fbfa447487b
-size 321563
diff --git a/docs/images/n8n-step4-agent-prompt.png b/docs/images/n8n-step4-agent-prompt.png
deleted file mode 100644
index bcdf6b62e..000000000
--- a/docs/images/n8n-step4-agent-prompt.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:74ea05dce07ff55320b21ad56dae102bd1c9904dfff9e64cf90ef242896338a6
-size 276720
diff --git a/docs/images/n8n-step5-mcp-client.png b/docs/images/n8n-step5-mcp-client.png
deleted file mode 100644
index c5394cbde..000000000
--- a/docs/images/n8n-step5-mcp-client.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:5baa452692ef670d495da95cdf78a63562fcae163db6602467c3eb6aa7e1e57c
-size 295486
diff --git a/docs/images/n8n-step6-test.png b/docs/images/n8n-step6-test.png
deleted file mode 100644
index 810246ded..000000000
--- a/docs/images/n8n-step6-test.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:94fba97a1b115d3e6717bf22f4208757f1cd179422b46c533af31a3e4bc63653
-size 253327
diff --git a/docs/images/openai-api-keys.png b/docs/images/openai-api-keys.png
deleted file mode 100644
index 813c91945..000000000
--- a/docs/images/openai-api-keys.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:f517c3953c368715eb1ce10a2f4c0441ec693205b3ed8f2bd7892ca650ac57dc
-size 579991
diff --git a/docs/images/openai-create-key.png b/docs/images/openai-create-key.png
deleted file mode 100644
index 1fafe7a0f..000000000
--- a/docs/images/openai-create-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:f4bb17e27687501df227f4431c65fdda653170f8160251643a074b1966421df9
-size 221963
diff --git a/docs/images/openai-provider-config.png b/docs/images/openai-provider-config.png
deleted file mode 100644
index 390ec3169..000000000
--- a/docs/images/openai-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:8145a0df6dc588de127824f3a808337be7c8b4bd6d32578f5218f01d24c0bebf
-size 102624
diff --git a/docs/images/openrouter-get-api-key.png b/docs/images/openrouter-get-api-key.png
deleted file mode 100644
index 00c663795..000000000
--- a/docs/images/openrouter-get-api-key.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:308b04752296540832178dfda7b4ab54cf703cda12d04bb2499d8363506dc2a1
-size 249506
diff --git a/docs/images/openrouter-models.png b/docs/images/openrouter-models.png
deleted file mode 100644
index 2685c2608..000000000
--- a/docs/images/openrouter-models.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:24624c69de2536bf23dcccc45c60f3db8a2e33ff1a8d9d64313c08454e8180f0
-size 350415
diff --git a/docs/images/openrouter-provider-config.png b/docs/images/openrouter-provider-config.png
deleted file mode 100644
index bc178f62b..000000000
--- a/docs/images/openrouter-provider-config.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:6b1b81284e58c734c3045116746bbb56089bde4fbc0f93e4bb22e1b718eddd8f
-size 569644
diff --git a/docs/images/openrouter-settings-card.png b/docs/images/openrouter-settings-card.png
deleted file mode 100644
index 2386849db..000000000
--- a/docs/images/openrouter-settings-card.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:b6b1bb07919152b3481f414fc062c8d453b946f6eede73f171b9dbfe6a555f23
-size 502057
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step1.png b/docs/images/setting-up-lm-studio/lmstudio-step1.png
deleted file mode 100644
index 7820b7e4c..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step1.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:8db2bfc75127269282c0933e0517713361938f9c9acadc461b7a0439f98b077c
-size 499738
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step2.png b/docs/images/setting-up-lm-studio/lmstudio-step2.png
deleted file mode 100644
index ce9d12f11..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step2.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:13db7f68939e5b1642220645bc9034bfd9f9f1a0457d5e1c7c6f729ab2159393
-size 467640
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step3.png b/docs/images/setting-up-lm-studio/lmstudio-step3.png
deleted file mode 100644
index c56ff785c..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step3.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:33754664f521f0f26765c4a379d839a157b9fe4c8d73f51bf9c4ed0c2ee35733
-size 448134
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step4-1.png b/docs/images/setting-up-lm-studio/lmstudio-step4-1.png
deleted file mode 100644
index 43d92f6eb..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step4-1.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:31a062590035b03c9a8a6181f6477c2a513f35ee063502eaf8f3e7e1291aee57
-size 429315
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step4-2.png b/docs/images/setting-up-lm-studio/lmstudio-step4-2.png
deleted file mode 100644
index 056cb990e..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step4-2.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:0da6041aadbf54e9cf3179e5b28fb87c4d6a512f78fa0c16cfa6f81738d8eba1
-size 444795
diff --git a/docs/images/setting-up-lm-studio/lmstudio-step5.png b/docs/images/setting-up-lm-studio/lmstudio-step5.png
deleted file mode 100644
index 2011c6382..000000000
--- a/docs/images/setting-up-lm-studio/lmstudio-step5.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:fbe3d7689776d29c7b782fd103d3663f1009564002c6ca0ec5f2b6c17b779872
-size 738406
diff --git a/docs/images/setting-up-ollama/ollama-step1.png b/docs/images/setting-up-ollama/ollama-step1.png
deleted file mode 100644
index f984bbbb4..000000000
--- a/docs/images/setting-up-ollama/ollama-step1.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:fb742262ad459bc97480b1b137aa110f2bcb762644b1c9c29cfc180d91b02995
-size 428125
diff --git a/docs/images/setting-up-ollama/ollama-step2.png b/docs/images/setting-up-ollama/ollama-step2.png
deleted file mode 100644
index 1d5d7bed2..000000000
--- a/docs/images/setting-up-ollama/ollama-step2.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:ddec30528e9d91eb65dcdb76f5f1826f5ec903535d80a82305406cec611be666
-size 233991
diff --git a/docs/images/setting-up-ollama/ollama-step3.png b/docs/images/setting-up-ollama/ollama-step3.png
deleted file mode 100644
index 113a9ec93..000000000
--- a/docs/images/setting-up-ollama/ollama-step3.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:adee5a3163aeb332f71690564fb4d8b558a56dd9a9328f6fd5765675ce8080e3
-size 281419
diff --git a/docs/images/setting-up-ollama/ollama-step4.png b/docs/images/setting-up-ollama/ollama-step4.png
deleted file mode 100644
index b3f14a70f..000000000
--- a/docs/images/setting-up-ollama/ollama-step4.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:c6ae26c56c8b9c0096685b263e6c8ac811bbb6c0d68bebeb35ef66b894b66e48
-size 526727
diff --git a/docs/images/switcher.png b/docs/images/switcher.png
deleted file mode 100644
index ddbfe67f2..000000000
--- a/docs/images/switcher.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:dc01a2ce678ac2585b0529d965c5821a70ae2525aba23d90b8d0f11d30448b14
-size 186755
diff --git a/docs/images/troubleshooting/failed-to-fetch-error.png b/docs/images/troubleshooting/failed-to-fetch-error.png
deleted file mode 100644
index 90317a937..000000000
--- a/docs/images/troubleshooting/failed-to-fetch-error.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:3080fc5e9c56f2cb8a82383b0c2c847beb0b9167fad13cc947d576abcaf59fb5
-size 12861
diff --git a/docs/images/troubleshooting/mcp-server-restart.png b/docs/images/troubleshooting/mcp-server-restart.png
deleted file mode 100644
index f0ad75890..000000000
--- a/docs/images/troubleshooting/mcp-server-restart.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1756a1bd57f8ef5644113b0f060b64a63eb0ac02efc868ee292a8cf24ccc653d
-size 138212
diff --git a/docs/images/troubleshooting/windows-task-manager.png b/docs/images/troubleshooting/windows-task-manager.png
deleted file mode 100644
index 361cf788c..000000000
--- a/docs/images/troubleshooting/windows-task-manager.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:dad86d71e6805df73ee28c65dc554e0ce084104dc18126a3e3a160a64c732e6f
-size 597121
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step1.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step1.png
deleted file mode 100644
index 5fc451633..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step1.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1187474cbb99962ca5018327c55d42959d5ef85da8b53d828a11c683c0fb29e0
-size 112993
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step10.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step10.png
deleted file mode 100644
index ef26f604f..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step10.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:79f5f61052e2f229f5a9d1d12f08809a0d9ef78bb3dd8b91e44c40592a3875d7
-size 86382
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step11.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step11.png
deleted file mode 100644
index 3b5c320aa..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step11.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:17f9ca86cdfef7b2ed133f4f4afc84db11bb3a22dd79c0e101a298ec9ec0f462
-size 462783
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step12.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step12.png
deleted file mode 100644
index 2826aee05..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step12.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:b672e5a8ca9d6b166172deda91049257e3f77da8a388e1ab250992aa34837c53
-size 447646
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step2.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step2.png
deleted file mode 100644
index 09edcb926..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step2.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:782f8caf7088f20ca42422d19ab2aab3c191b944614e63b63dcfa986fea70205
-size 281701
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step3.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step3.png
deleted file mode 100644
index 5937179e5..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step3.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:c466b78f104f2ada7f2e4d2da906592b4086081c30611aa08991b87573a41237
-size 119208
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step4.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step4.png
deleted file mode 100644
index fc4cbc277..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step4.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:61397fb5956806059223b850f9102556750d984ca8a482219f05f7b678117a35
-size 158993
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step5.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step5.png
deleted file mode 100644
index 6e6d02a3d..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step5.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:0582445ec31e5fad85a43f4f529632a723c9238c6a592fb5c87a44b77168e069
-size 60134
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step6.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step6.png
deleted file mode 100644
index 8b39bfddb..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step6.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:3816bba8e3d80f4f71d7a9eee9020277f7c2b20d25da06a0c754c488f46566b7
-size 238727
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step7.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step7.png
deleted file mode 100644
index 599e8516a..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step7.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:1ce301d8a332fe7e5208a032a46b940a52574dba02c0c6e291c49b82ac7d0e03
-size 208603
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step8.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step8.png
deleted file mode 100644
index fdac8b50e..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step8.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:17b387e3ab7705f32525f9d4e3f37e3195f621a569449bce0f6dfc30ea4ebb51
-size 200057
diff --git a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step9.png b/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step9.png
deleted file mode 100644
index 463da2e83..000000000
--- a/docs/images/using-lm-studio-openais-gpt-oss/lm-studio-openais-step9.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:6caa57f5e881e03f03d4d9ee33e459d71609e776ec5e0dc0a0988a2bbe018c6b
-size 76020
diff --git a/docs/images/windows-installation/troubleshoot-search-restart-agent-task-manager.png b/docs/images/windows-installation/troubleshoot-search-restart-agent-task-manager.png
deleted file mode 100644
index 211af2da3..000000000
--- a/docs/images/windows-installation/troubleshoot-search-restart-agent-task-manager.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:05df75e96acc2c914c12d601bb920df3dd355e7a397a4ec00018e44f278553c3
-size 1505716
diff --git a/docs/images/windows-installation/windows-installation-allow-browseros-agent.png b/docs/images/windows-installation/windows-installation-allow-browseros-agent.png
deleted file mode 100644
index bf70965b9..000000000
--- a/docs/images/windows-installation/windows-installation-allow-browseros-agent.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:b787e90f8255654d6a1cacb12eb6a99b1bda0d03fdffbc78b45cbdf28953f518
-size 1454515
diff --git a/docs/images/windows-installation/windows-installation-app-on-desktop.jpeg b/docs/images/windows-installation/windows-installation-app-on-desktop.jpeg
deleted file mode 100644
index ff5bbfd7a..000000000
--- a/docs/images/windows-installation/windows-installation-app-on-desktop.jpeg
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:731f0a30cc792831a487f0e0f27c709176ded3c0f3648e745ba5475e4e50c661
-size 970984
diff --git a/docs/images/windows-installation/windows-installation-installer-tmp-folder.png b/docs/images/windows-installation/windows-installation-installer-tmp-folder.png
deleted file mode 100644
index 811076e23..000000000
--- a/docs/images/windows-installation/windows-installation-installer-tmp-folder.png
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:09e74aa3015bbb3e0f7ebc7ae6462f5fe4720ca31e82cff2f9e7553da0fec6e1
-size 2655776
diff --git a/docs/index.mdx b/docs/index.mdx
index a030e16df..a3d085863 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -4,7 +4,7 @@ description: "The open-source AI browser that turns your words into actions"
---
-
+
BrowserOS is an AI-native browser that lets you automate any web task by describing it in plain English. Built on Chromium, it runs AI agents locally on your machine—keeping your data private while giving you superpowers for browsing.
diff --git a/docs/integrations/n8n-node.png b/docs/integrations/n8n-node.png
new file mode 100644
index 000000000..f491fc2c2
Binary files /dev/null and b/docs/integrations/n8n-node.png differ
diff --git a/docs/integrations/n8n-step3-workflow.png b/docs/integrations/n8n-step3-workflow.png
new file mode 100644
index 000000000..c7a2dfe12
Binary files /dev/null and b/docs/integrations/n8n-step3-workflow.png differ
diff --git a/docs/integrations/n8n-step4-agent-prompt.png b/docs/integrations/n8n-step4-agent-prompt.png
new file mode 100644
index 000000000..7985f43ed
Binary files /dev/null and b/docs/integrations/n8n-step4-agent-prompt.png differ
diff --git a/docs/integrations/n8n-step5-mcp-client.png b/docs/integrations/n8n-step5-mcp-client.png
new file mode 100644
index 000000000..b856850a5
Binary files /dev/null and b/docs/integrations/n8n-step5-mcp-client.png differ
diff --git a/docs/integrations/n8n-step6-test.png b/docs/integrations/n8n-step6-test.png
new file mode 100644
index 000000000..6124a0c93
Binary files /dev/null and b/docs/integrations/n8n-step6-test.png differ
diff --git a/docs/integrations/n8n.mdx b/docs/integrations/n8n.mdx
index 9113c0a6f..26b42dce2 100644
--- a/docs/integrations/n8n.mdx
+++ b/docs/integrations/n8n.mdx
@@ -24,7 +24,7 @@ Before you start:
In n8n, go to **Settings → Community Nodes** and install `n8n-nodes-mcp`:
-
+
### 2. Create a workflow
@@ -35,13 +35,13 @@ Build a workflow with these nodes:
3. Add a **Chat Model** under the AI Agent (e.g., OpenAI, Claude)
4. Add an **MCP Client Tool** under the AI Agent
-
+
### 3. Configure the AI Agent
In the AI Agent node, set **Source for Prompt** to **Connected Chat Trigger Node**.
-
+
### 4. Connect to BrowserOS
@@ -50,7 +50,7 @@ Click on the MCP Client node and configure:
- **Endpoint**: Your BrowserOS MCP URL (find it in Settings → BrowserOS as MCP)
- **Server Transport**: `HTTP Streamable`
-
+
### 5. Test it
@@ -60,7 +60,7 @@ Save the workflow, click **Open chat**, and try:
open google.com in BrowserOS
```
-
+
## Troubleshooting
diff --git a/docs/troubleshooting/connection-issues.mdx b/docs/troubleshooting/connection-issues.mdx
index c9b7cb1ff..6168cac8f 100644
--- a/docs/troubleshooting/connection-issues.mdx
+++ b/docs/troubleshooting/connection-issues.mdx
@@ -6,7 +6,7 @@ description: "How to fix connection issues when the BrowserOS agent is not respo
If you see **"Failed to Fetch"** or **"Unable to connect to BrowserOS agent"**, your agent has been killed.
-
+
## Windows: Did you allow the BrowserOS Agent?
@@ -14,7 +14,7 @@ If you see **"Failed to Fetch"** or **"Unable to connect to BrowserOS agent"**,
When BrowserOS starts for the first time on Windows, a popup will ask if you want to allow **BrowserOS Agent** to access the network. Click **Allow** — the agent runs as a separate process alongside the browser and needs this permission to work. If you clicked **Cancel** or missed this prompt, the agent won't be able to connect.
-
+
To fix this, go to **Windows Security → Allow an app through your network settings**, and make sure **BrowserOS Agent** is enabled.
@@ -26,7 +26,7 @@ To fix this, go to **Windows Security → Allow an app through your network sett
Open **Settings** from the sidebar, scroll to the MCP Server section, and click **Restart**. Wait a couple of minutes.
-
+
+
+
diff --git a/docs/update/macos.mdx b/docs/update/macos.mdx
index 4c84708fd..90047ed6c 100644
--- a/docs/update/macos.mdx
+++ b/docs/update/macos.mdx
@@ -8,7 +8,7 @@ description: "How to update BrowserOS on macOS"
Go to **Settings > About BrowserOS** to see your current version.
-
+
+
+
Wait about 30–40 seconds. The temporary folder will disappear on its own, and the updated **BrowserOS** app will automatically appear on your desktop.
-
+
+