Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Studio: Browser use switch on the browser's new tab page (#15540)

Michael Han7c65edbddd73
diff --git a/studio/frontend/src/features/browser/agent/composer-toggle.tsx b/studio/frontend/src/features/browser/agent/composer-toggle.tsx
index 8fb8f9a411b..9588222bc3e 100644
--- a/studio/frontend/src/features/browser/agent/composer-toggle.tsx
+++ b/studio/frontend/src/features/browser/agent/composer-toggle.tsx
@@ -12,7 +12,7 @@ import { useBrowserAgentStore } from "./agent-store";
/** Like MCP: the model needs Studio's tool loop, so a loaded model without tools rules it out; so
* does a chat with nowhere to show the panel (mobile, compare), where no browser tool is sent. */
-function useBrowserAgentDisabled(): boolean {
+export function useBrowserAgentDisabled(): boolean {
const noTools = useChatRuntimeStore((s) => !!s.params.checkpoint && !s.modelLoading && !s.supportsTools);
// Both hooks every render: `noTools || !useBrowserPanelAvailable()` skips one once a tool-less
// model loads, and React's changed hook order crashes the chat.
diff --git a/studio/frontend/src/features/browser/new-tab-page.tsx b/studio/frontend/src/features/browser/new-tab-page.tsx
index a3fad5ce455..d807f7a7bd1 100644
--- a/studio/frontend/src/features/browser/new-tab-page.tsx
+++ b/studio/frontend/src/features/browser/new-tab-page.tsx
@@ -13,8 +13,12 @@ import {
ViewOffSlashIcon,
} from "@hugeicons/core-free-icons";
import { HugeiconsIcon, type IconSvgElement } from "@hugeicons/react";
-import { type ReactNode, useMemo, useState } from "react";
+import { type ReactNode, useId, useMemo, useState } from "react";
+import { Switch } from "@/components/ui/switch";
+import { CursorInWindowIcon } from "@/lib/browser-use-icon";
import { hostOf } from "./address";
+import { useBrowserAgentStore } from "./agent/agent-store";
+import { useBrowserAgentDisabled } from "./agent/composer-toggle";
import { type HistoryItem, useBrowserHistoryStore } from "./history-store";
import { LinkContextMenu, MenuRow } from "./link-context-menu";
import { useNativeBrowser } from "./native-support";
@@ -196,6 +200,47 @@ function ToolButton({
);
}
+/** The composer's Browser use switch: the same store, so its pill shows as soon as this is on. */
+function BrowserUseToggle() {
+ const t = useT();
+ const id = useId();
+ const disabled = useBrowserAgentDisabled();
+ const enabled = useBrowserAgentStore((state) => state.enabled);
+ return (
+ <label
+ htmlFor={id}
+ className={cn(
+ "flex min-w-0 items-center gap-3 rounded-lg bg-[color-mix(in_oklab,var(--foreground)_calc(4%*var(--contrast-wash-gain,1)),transparent)] px-5 py-3",
+ disabled ? "cursor-default" : "cursor-pointer",
+ )}
+ >
+ <HugeiconsIcon
+ icon={CursorInWindowIcon}
+ strokeWidth={1.75}
+ className="me-1 size-6 shrink-0 text-muted-foreground"
+ />
+ <span className="min-w-0 flex-1">
+ <span className="block text-ui-15 text-foreground">
+ {t("browser.browserUse.label")}
+ </span>
+ <span className="block text-ui-13 text-muted-foreground">
+ {t(
+ disabled
+ ? "browser.browserUse.unavailable"
+ : "browser.browserUse.description",
+ )}
+ </span>
+ </span>
+ <Switch
+ id={id}
+ checked={enabled && !disabled}
+ disabled={disabled}
+ onCheckedChange={(on) => useBrowserAgentStore.getState().setEnabled(on)}
+ />
+ </label>
+ );
+}
+
function PageButton({
label,
icon,
@@ -298,6 +343,7 @@ export function NewTabPage({ tabId }: { tabId: string }) {
</div>
</section>
) : null}
+ <BrowserUseToggle />
{showRecents && recents.length > 0 ? (
<section className="flex flex-col gap-3">
<SectionTitle
diff --git a/studio/frontend/src/i18n/locales/ar.ts b/studio/frontend/src/i18n/locales/ar.ts
index 48cfb2e8e81..0634865ffaf 100644
--- a/studio/frontend/src/i18n/locales/ar.ts
+++ b/studio/frontend/src/i18n/locales/ar.ts
@@ -139,6 +139,11 @@ export const ar = {
more: "المزيد",
addressPlaceholder: "ابحث أو أدخل عنوان URL",
local: "محلي",
+ browserUse: {
+ label: "استخدام المتصفح",
+ description: "السماح للنماذج بالتحكم في المتصفح المدمج",
+ unavailable: "حمّل نموذجًا يمكنه استدعاء الأدوات ليتمكن من استخدام المتصفح.",
+ },
suggested: "مقترحات",
suggestedMenu: {
open: "فتح",
diff --git a/studio/frontend/src/i18n/locales/de.ts b/studio/frontend/src/i18n/locales/de.ts
index c0723e8a4fc..93bcd184ff9 100644
--- a/studio/frontend/src/i18n/locales/de.ts
+++ b/studio/frontend/src/i18n/locales/de.ts
@@ -139,6 +139,11 @@ export const de = {
more: "Mehr",
addressPlaceholder: "Suchen oder URL eingeben",
local: "Lokal",
+ browserUse: {
+ label: "Browsernutzung",
+ description: "Modelle den integrierten Browser steuern lassen",
+ unavailable: "Lade ein Modell, das Tools aufrufen kann, damit es den Browser nutzen kann.",
+ },
suggested: "Vorschläge",
suggestedMenu: {
open: "Öffnen",
diff --git a/studio/frontend/src/i18n/locales/en.ts b/studio/frontend/src/i18n/locales/en.ts
index b4fd293640d..b2d663fb504 100644
--- a/studio/frontend/src/i18n/locales/en.ts
+++ b/studio/frontend/src/i18n/locales/en.ts
@@ -136,6 +136,11 @@ export const en = {
more: "More",
addressPlaceholder: "Search or enter a URL",
local: "Local",
+ browserUse: {
+ label: "Browser use",
+ description: "Let models control the in-built browser",
+ unavailable: "Load a model that can call tools to let it use the browser.",
+ },
suggested: "Suggested",
suggestedMenu: {
open: "Open",
diff --git a/studio/frontend/src/i18n/locales/es.ts b/studio/frontend/src/i18n/locales/es.ts
index a2a4b82a348..fef6e818d00 100644
--- a/studio/frontend/src/i18n/locales/es.ts
+++ b/studio/frontend/src/i18n/locales/es.ts
@@ -139,6 +139,11 @@ export const es = {
more: "Más",
addressPlaceholder: "Busca o escribe una URL",
local: "Local",
+ browserUse: {
+ label: "Uso del navegador",
+ description: "Permite que los modelos controlen el navegador integrado",
+ unavailable: "Carga un modelo que pueda llamar herramientas para que use el navegador.",
+ },
suggested: "Sugerencias",
suggestedMenu: {
open: "Abrir",
diff --git a/studio/frontend/src/i18n/locales/fr.ts b/studio/frontend/src/i18n/locales/fr.ts
index d003b900b44..35d983ad11b 100644
--- a/studio/frontend/src/i18n/locales/fr.ts
+++ b/studio/frontend/src/i18n/locales/fr.ts
@@ -139,6 +139,11 @@ export const fr = {
more: "Plus",
addressPlaceholder: "Rechercher ou saisir une URL",
local: "Local",
+ browserUse: {
+ label: "Utilisation du navigateur",
+ description: "Laisser les modèles contrôler le navigateur intégré",
+ unavailable: "Chargez un modèle capable d'appeler des outils pour qu'il utilise le navigateur.",
+ },
suggested: "Suggestions",
suggestedMenu: {
open: "Ouvrir",
diff --git a/studio/frontend/src/i18n/locales/he.ts b/studio/frontend/src/i18n/locales/he.ts
index bd1804d158a..9de7911cfc5 100644
--- a/studio/frontend/src/i18n/locales/he.ts
+++ b/studio/frontend/src/i18n/locales/he.ts
@@ -140,6 +140,11 @@ export const he = {
more: "עוד",
addressPlaceholder: "חפש או הזן URL",
local: "מקומי",
+ browserUse: {
+ label: "שימוש בדפדפן",
+ description: "אפשר למודלים לשלוט בדפדפן המובנה",
+ unavailable: "טען מודל שיכול לקרוא לכלים כדי שיוכל להשתמש בדפדפן.",
+ },
suggested: "מוצעים",
suggestedMenu: {
open: "פתח",
diff --git a/studio/frontend/src/i18n/locales/hi.ts b/studio/frontend/src/i18n/locales/hi.ts
index beb66a31d56..4ccc17d0967 100644
--- a/studio/frontend/src/i18n/locales/hi.ts
+++ b/studio/frontend/src/i18n/locales/hi.ts
@@ -139,6 +139,11 @@ export const hi = {
more: "और",
addressPlaceholder: "खोजें या URL डालें",
local: "लोकल",
+ browserUse: {
+ label: "ब्राउज़र उपयोग",
+ description: "मॉडलों को बिल्ट-इन ब्राउज़र नियंत्रित करने दें",
+ unavailable: "ब्राउज़र इस्तेमाल करने देने के लिए ऐसा मॉडल लोड करें जो टूल कॉल कर सके।",
+ },
suggested: "सुझाव",
suggestedMenu: {
open: "खोलें",
diff --git a/studio/frontend/src/i18n/locales/it.ts b/studio/frontend/src/i18n/locales/it.ts
index 995e597427d..cd18a714af5 100644
--- a/studio/frontend/src/i18n/locales/it.ts
+++ b/studio/frontend/src/i18n/locales/it.ts
@@ -138,6 +138,11 @@ export const it = {
more: "Altro",
addressPlaceholder: "Cerca o inserisci un URL",
local: "Locale",
+ browserUse: {
+ label: "Uso del browser",
+ description: "Consenti ai modelli di controllare il browser integrato",
+ unavailable: "Carica un modello in grado di chiamare strumenti per fargli usare il browser.",
+ },
suggested: "Suggeriti",
suggestedMenu: {
open: "Apri",
diff --git a/studio/frontend/src/i18n/locales/ja.ts b/studio/frontend/src/i18n/locales/ja.ts
index 306c81b526d..a1baa375f48 100644
--- a/studio/frontend/src/i18n/locales/ja.ts
+++ b/studio/frontend/src/i18n/locales/ja.ts
@@ -140,6 +140,11 @@ export const ja = {
more: "その他",
addressPlaceholder: "検索または URL を入力",
local: "ローカル",
+ browserUse: {
+ label: "ブラウザ操作",
+ description: "モデルに内蔵ブラウザを操作させる",
+ unavailable: "ブラウザを使わせるには、ツールを呼び出せるモデルを読み込んでください。",
+ },
suggested: "おすすめ",
suggestedMenu: {
open: "開く",
diff --git a/studio/frontend/src/i18n/locales/ko.ts b/studio/frontend/src/i18n/locales/ko.ts
index 369a82553a8..a8c036bbcda 100644
--- a/studio/frontend/src/i18n/locales/ko.ts
+++ b/studio/frontend/src/i18n/locales/ko.ts
@@ -139,6 +139,11 @@ export const ko = {
more: "더보기",
addressPlaceholder: "검색어 또는 URL 입력",
local: "로컬",
+ browserUse: {
+ label: "브라우저 사용",
+ description: "모델이 내장 브라우저를 제어하도록 허용",
+ unavailable: "브라우저를 사용하게 하려면 도구를 호출할 수 있는 모델을 불러오세요.",
+ },
suggested: "추천",
suggestedMenu: {
open: "열기",
diff --git a/studio/frontend/src/i18n/locales/pt-br.ts b/studio/frontend/src/i18n/locales/pt-br.ts
index 0124f8c5d1c..762daa64883 100644
--- a/studio/frontend/src/i18n/locales/pt-br.ts
+++ b/studio/frontend/src/i18n/locales/pt-br.ts
@@ -139,6 +139,11 @@ export const ptBR = {
more: "Mais",
addressPlaceholder: "Pesquise ou digite um URL",
local: "Local",
+ browserUse: {
+ label: "Uso do navegador",
+ description: "Permite que os modelos controlem o navegador integrado",
+ unavailable: "Carregue um modelo que chame ferramentas para que ele use o navegador.",
+ },
suggested: "Sugestões",
suggestedMenu: {
open: "Abrir",
diff --git a/studio/frontend/src/i18n/locales/ru.ts b/studio/frontend/src/i18n/locales/ru.ts
index 88c555516eb..9e917d2922b 100644
--- a/studio/frontend/src/i18n/locales/ru.ts
+++ b/studio/frontend/src/i18n/locales/ru.ts
@@ -139,6 +139,11 @@ export const ru = {
more: "Ещё",
addressPlaceholder: "Введите запрос или URL",
local: "Локальный",
+ browserUse: {
+ label: "Работа с браузером",
+ description: "Разрешить моделям управлять встроенным браузером",
+ unavailable: "Загрузите модель с поддержкой вызова инструментов, чтобы она могла работать с браузером.",
+ },
suggested: "Рекомендуемые",
suggestedMenu: {
open: "Открыть",
diff --git a/studio/frontend/src/i18n/locales/sv.ts b/studio/frontend/src/i18n/locales/sv.ts
index 72322840057..5f7434a8ad6 100644
--- a/studio/frontend/src/i18n/locales/sv.ts
+++ b/studio/frontend/src/i18n/locales/sv.ts
@@ -137,6 +137,11 @@ export const sv = {
more: "Mer",
addressPlaceholder: "Sök eller ange en URL",
local: "Lokal",
+ browserUse: {
+ label: "Webbläsaranvändning",
+ description: "Låt modeller styra den inbyggda webbläsaren",
+ unavailable: "Läs in en modell som kan anropa verktyg för att låta den använda webbläsaren.",
+ },
suggested: "Förslag",
suggestedMenu: {
open: "Öppna",
diff --git a/studio/frontend/src/i18n/locales/zh-CN.ts b/studio/frontend/src/i18n/locales/zh-CN.ts
index bc418bec9be..fef38004932 100644
--- a/studio/frontend/src/i18n/locales/zh-CN.ts
+++ b/studio/frontend/src/i18n/locales/zh-CN.ts
@@ -139,6 +139,11 @@ export const zhCN = {
more: "更多",
addressPlaceholder: "搜索或输入网址",
local: "本地",
+ browserUse: {
+ label: "浏览器操作",
+ description: "允许模型控制内置浏览器",
+ unavailable: "请加载支持工具调用的模型,才能让它使用浏览器。",
+ },
suggested: "推荐",
suggestedMenu: {
open: "打开",
diff --git a/studio/frontend/tests/browser-new-tab-browser-use.test.ts b/studio/frontend/tests/browser-new-tab-browser-use.test.ts
new file mode 100644
index 00000000000..f29e3a270a0
--- /dev/null
+++ b/studio/frontend/tests/browser-new-tab-browser-use.test.ts
@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { readSrc } from "./helpers/kit.ts";
+
+const PAGE = readSrc("features/browser/new-tab-page.tsx");
+
+test("the new tab page's Browser use switch drives the composer's store", () => {
+ assert.match(PAGE, /const enabled = useBrowserAgentStore\(\(state\) => state\.enabled\);/);
+ assert.match(PAGE, /onCheckedChange=\{\(on\) => useBrowserAgentStore\.getState\(\)\.setEnabled\(on\)\}/);
+ // Same rule as the composer: off and disabled where the composer's item is.
+ assert.match(PAGE, /const disabled = useBrowserAgentDisabled\(\);/);
+ assert.match(PAGE, /checked=\{enabled && !disabled\}\s*disabled=\{disabled\}/);
+ assert.match(
+ readSrc("features/browser/agent/composer-toggle.tsx"),
+ /export function useBrowserAgentDisabled\(\): boolean \{/,
+ );
+});
+
+test("the switch sits just under Suggested, outside its show setting", () => {
+ assert.match(
+ PAGE,
+ /<SuggestedSite key=\{site\.url\} site=\{site\} tabId=\{tabId\} \/>\s*\)\)\}\s*<\/div>\s*<\/section>\s*\) : null\}\s*<BrowserUseToggle \/>\s*\{showRecents/,
+ );
+});
+
+test("every locale has the switch's strings", () => {
+ for (const locale of ["ar", "de", "en", "es", "fr", "he", "hi", "it", "ja", "ko", "pt-br", "ru", "sv", "zh-CN"]) {
+ assert.match(
+ readSrc(`i18n/locales/${locale}.ts`),
+ /\n {4}browserUse: \{\n {6}label: "[^"]+",\n {6}description: "[^"]+",\n {6}unavailable: "[^"]+",\n {4}\},/,
+ locale,
+ );
+ }
+});