Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
<!doctype html>
<html lang="en" data-theme="dark">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
<title>Settings, explained — WebBrain User Guide</title>
<meta name="description" content="A plain-language guide to every WebBrain Settings tab and the Providers and Permissions pages, with recommended defaults and screenshots.">
<link rel="canonical" href="https://webbrain.one/docs/settings/"><link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/settings/"><link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/settings/">
<link rel="icon" href="/favicon.png"><script>try{document.documentElement.dataset.theme=localStorage.getItem('webbrain-theme')||'dark'}catch(_){}</script><link rel="stylesheet" href="/docs/assets/docs.css?v=20261028">
<!-- Plausible analytics: start -->
<!-- Privacy-friendly analytics by Plausible -->
<script async src="https://157.230.3.9.sslip.io/js/pa-omp0F7DsOXM4sGKR50l7S.js"></script>
<script>
window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
plausible.init()
</script>
<!-- Plausible analytics: end -->
<!-- Site footer styles: start -->
<style>
.wb-footer {
--wb-footer-text: var(--text, var(--ink, #2c1810));
--wb-footer-dim: var(--text-dim, var(--muted, #6b5b47));
--wb-footer-line: var(--border, var(--line, rgba(89, 55, 25, 0.15)));
margin: 0;
padding: 0;
border-top: 1px solid var(--wb-footer-line);
background: var(--wb-footer-bg, none);
color: var(--wb-footer-dim);
font-size: 13px;
line-height: 1.5;
text-align: start;
}
.wb-footer-inner {
width: var(--wb-footer-width, min(calc(100% - 48px), 1100px));
margin: 0 auto;
padding: 26px 0 30px;
display: flex;
flex-direction: column;
gap: 18px;
}
/* Page links start on the brand's left edge; the social icons sit at
the far end of the same row. */
.wb-footer-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 14px 32px; }
.wb-footer-brand { display: flex; flex-direction: column; gap: 5px; }
.wb-footer-tagline { margin: 0; color: var(--wb-footer-text); font-size: 15px; font-weight: 700; line-height: 1.4; }
.wb-footer-copy { margin: 0; }
.wb-footer-copy a { color: var(--wb-footer-text); font-weight: 650; text-decoration: none; }
.wb-footer-links { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
.wb-footer-social { display: flex; align-items: center; gap: 8px; }
.wb-footer-links a { color: var(--wb-footer-dim); font-weight: 600; text-decoration: none; }
.wb-footer a:hover { color: var(--wb-footer-text); text-decoration: none; }
.wb-footer a:focus-visible { outline: 2px solid currentColor; outline-offset: 3px; border-radius: 4px; }
.wb-footer-icon { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; margin: -4px 0; border-radius: 6px; }
.wb-footer-icon:hover { background: color-mix(in srgb, currentColor 12%, transparent); }
.wb-footer-icon svg { display: block; width: 15px; height: 15px; }
/* Only shown without JavaScript, when the language picker can't run. */
.wb-footer-languages { display: none; flex-wrap: wrap; gap: 6px 12px; width: 100%; direction: ltr; }
.wb-footer-languages span { color: var(--wb-footer-text); font-weight: 700; }
@media (max-width: 860px) {
.wb-footer-inner { width: var(--wb-footer-width, calc(100% - 32px)); }
}
</style>
<!-- Site footer styles: end -->
</head>
<body class="doc-page">
<a class="skip-link" href="#main">Skip to content</a>
<header class="site-header"><div class="header-inner"><a class="brand" href="/"><img src="/logo-github.png" alt=""><span>WebBrain</span><span class="brand-docs">User guide</span></a><nav class="top-nav" aria-label="Primary"><a href="/">Home</a><a href="/docs/" aria-current="page">Docs</a><a href="/blog/">Blog</a><a href="https://github.com/webbrain-one/webbrain">GitHub</a></nav><div class="header-tools"><a class="lang-switch" href="/docs/zh/settings/" aria-label="Read in Chinese"><span class="active">EN</span><span>中文</span></a><button class="icon-button" type="button" data-theme-toggle aria-label="Use light theme">☀</button><button class="sidebar-toggle" type="button" data-sidebar-toggle aria-expanded="false" aria-label="Open documentation menu">☰</button></div></div></header>
<div class="docs-shell">
<aside class="docs-sidebar" aria-label="Documentation"><div class="sidebar-group"><div class="sidebar-label">Start here</div><nav><a href="/docs/">Overview</a><a href="/docs/faq/">FAQ</a></nav></div><div class="sidebar-group"><div class="sidebar-label">Use WebBrain</div><nav><a href="/docs/settings/" aria-current="page">Settings, explained</a><a href="/docs/providers/">Providers & models</a><a href="/companion/">WebBrain Companion</a><a href="/docs/safety/">Modes, safety & privacy</a><a href="/docs/apocalypse-mode/">Apocalypse Mode</a><a href="/docs/formats/">Exports & workflows</a><a href="/docs/mcp/">MCP server</a><a href="/docs/lm-studio/">LM Studio plugin</a><a href="/docs/ollama/">Ollama</a></nav></div><div class="sidebar-group"><div class="sidebar-label">For builders</div><nav><a href="https://github.com/webbrain-one/webbrain/tree/main/docs">Technical docs ↗</a></nav></div><div class="sidebar-group"><div class="sidebar-label">Community</div><nav><a href="https://discord.gg/cgC325ssfw">Discord Support</a></nav></div></aside>
<main class="doc-main" id="main">
<div class="breadcrumb"><a href="/docs/">Docs</a> / Settings</div>
<section class="doc-hero"><div class="eyebrow">Settings, without guesswork</div><h1>Know what to change—and what to leave alone.</h1><p class="lede">Open Settings from the gear in the side panel or from your browser’s extension options. The chat model and its helper models have their own <strong>Providers</strong> page: open it from <strong>More…</strong> in the side panel’s model menu, or from the Providers link at the top of Settings. Site permissions have a page too: open it with <strong>Manage site permissions</strong> in the <strong>⚠</strong> menu next to the microphone. Most people only need General, Providers and Permissions; the other tabs solve specific problems.</p><div class="meta">Screenshots from the Settings reorganization · synthetic configuration, no real credentials</div></section>
<section class="doc-section" id="defaults"><h2>A good default setup</h2><div class="table-wrap"><table><thead><tr><th>Control</th><th>Recommended</th><th>Why</th></tr></thead><tbody><tr><td>Plan before Act</td><td>Try planning</td><td>Uses a plan when available. If planning still fails after a retry, WebBrain tells you and continues that turn under the normal safeguards.</td></tr><tr><td>Plan review stops</td><td>Below confidence threshold</td><td>Low-confidence plans pause; confident plans can continue.</td></tr><tr><td>Review below confidence</td><td>90%</td><td>A conservative balance between supervision and flow.</td></tr><tr><td>Max Agent Steps</td><td>130</td><td>Enough room for multi-step work. Stop the run yourself if behavior looks repetitive.</td></tr><tr><td>LLM request timeout</td><td>120 seconds</td><td>Cloud models usually answer sooner; large local models may need the extra startup time.</td></tr><tr><td>Auto-screenshot</td><td>On navigation</td><td>One picture after the agent opens a page, not after every click or keystroke. Choose On state change when the vision model should check each action.</td></tr><tr><td>Cloud cost allowances</td><td>$10 per session and $10 in total</td><td>A mechanical stop for paid model calls; raise or lower it in Budgets.</td></tr><tr><td>Scheduled action confirmation</td><td>On</td><td>Unattended work still pauses before consequential actions.</td></tr><tr><td>Permission gate</td><td>On</td><td>WebBrain asks before it first acts on a site and remembers your explicit choice. The ⚠ button next to the microphone in the side panel switches it too.</td></tr><tr><td>Decision models</td><td>Auto</td><td>Nothing to set up. Uses Compass VLD Tiny v5 for completion checks once it is downloaded, or D1 when only D1 is (Compass’s managed decision model while WebBrain Cloud is active and neither is), and no decision model otherwise.</td></tr><tr><td>In-browser vision model</td><td>Auto</td><td>Reads screenshots with Compass VLD Tiny v5 once it is downloaded (Ternary Bonsai 2 2B Vision when only that one is), only when your chat model cannot see images.</td></tr></tbody></table></div></section>
<section class="doc-section" id="general"><div class="eyebrow">Everyday</div><h2>General: how the agent behaves</h2><p>Appearance and download location are cosmetic. The controls below them change the agent loop: how it plans, when you review, and what it captures. Language and zoom are picked in the side panel, so they are not repeated here.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-general.jpg"><img src="/docs/assets/screenshots/settings-general.jpg" alt="WebBrain General settings with the search box, appearance, download folder, planning and plan review controls"></a><figcaption>General starts with the controls you are most likely to use. Click the image to view it at full size.</figcaption></figure>
<h3>Planning controls</h3><ul><li><strong>Try planning</strong> is the best general choice. WebBrain attempts a structured plan before Act or Dev tools run; if planning still fails after a retry, WebBrain shows a warning and that turn continues without a plan, under the normal safeguards. When Auto picks Act or Dev for a message and is sure it is a short, direct task, such as opening a page, searching, or filling in and submitting one form, Try skips the full plan and runs only the compact intent check. Tasks with several goals, many items, several sites, scheduling, or payments, deletions and other risky steps still get a plan, and so does every Act or Dev turn while plan review is set to always ask.</li><li><strong>Strict planning</strong> cancels the run when a valid plan cannot be produced. Use it where “no plan, no action” matters more than convenience.</li><li><strong>Off</strong> removes the extra full-plan call but keeps the compact intent check; if that check still fails after a retry, the turn continues the same way. It can be faster and cheaper, but you lose the plan review checkpoint.</li></ul>
<h3>Auto-screenshot</h3><p><strong>On navigation</strong> (the default) takes one picture after the agent opens a page, so the vision model sees where it landed. <strong>On state change</strong> also captures after clicks, typing and other actions that change the page, which costs more image tokens; <strong>Every step</strong> captures after every tool call; <strong>Off</strong> captures only when asked.</p>
<h3>Search</h3><p>The search box below the tab bar looks through General, Budgets, CAPTCHA and Advanced at once, whichever of them you are on, and shows each match under its tab name. While it shows results, no tab is marked as the current one. Click a tab name above the results to open that tab, or pick a tab in the bar; either ends the search, and so does clearing it, which returns you to the tab you were on.</p>
</section>
<section class="doc-section" id="budgets"><div class="eyebrow">Limits</div><h2>Budgets: how far one task may go</h2><p>Budgets gathers every limit on spending, waiting and work in one tab: the cloud cost allowances, how long a question waits for you, the step limit, the model timeout and the screenshot image budget.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-budgets.jpg"><img src="/docs/assets/screenshots/settings-budgets.jpg" alt="WebBrain Budgets settings with the cloud cost allowances, question timeout, step limit, request timeout and image budget"></a><figcaption>Every mechanical stop in one place. Example values are the defaults.</figcaption></figure><div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it limits</th></tr></thead><tbody><tr><td>Cloud cost session allowance</td><td>$10.00</td><td>Estimated spend on cloud and router model calls in one conversation. WebBrain stops before the next call once it is reached.</td></tr><tr><td>Cloud cost total allowance</td><td>$10.00</td><td>Estimated spend across all conversations. The label shows what has been spent so far, for example <code>$0.00 / $10.00</code>; <strong>Reset spend</strong> starts the count again.</td></tr><tr><td>Clarify timeout</td><td>60 seconds</td><td>How long a question card waits for your answer before WebBrain answers it itself. Instant and Off are at the ends of the slider.</td></tr><tr><td>When a question times out</td><td>Finish the task</td><td>Whether the timed-out answer keeps the task moving or takes the safe choice.</td></tr><tr><td>Max Agent Steps</td><td>130</td><td>Tool-use steps for one message, not chat messages.</td></tr><tr><td>LLM request timeout</td><td>120 seconds</td><td>How long WebBrain waits for the model to start answering.</td></tr><tr><td>Image budget</td><td>Auto detail, no per-turn limit, 1568 px</td><td>How many screenshots a turn may send to the vision model and at what size.</td></tr></tbody></table></div>
<h3>Steps and timeouts</h3><p>Higher step limits allow longer workflows and more chances to recover, but they can also spend more tokens. The request timeout only governs how long WebBrain waits for the model to start responding; it does not cut off a response that is already streaming.</p>
<div class="callout warning"><strong class="callout-title">Unlimited is not the same as reliable</strong><p>Setting the step slider to ∞ removes a mechanical stop. It does not make a model less likely to loop. Keep a finite limit unless you are actively supervising a long job.</p></div>
</section>
<section class="doc-section" id="memory"><div class="eyebrow">When needed</div><h2>Memory: decide what persists</h2><figure class="shot"><a href="/docs/assets/screenshots/settings-memory.jpg"><img src="/docs/assets/screenshots/settings-memory.jpg" alt="WebBrain Memory settings showing encrypted cloud sync and profile auto-fill"></a><figcaption>Memory groups three different features: encrypted sync, profile auto-fill, and user memory.</figcaption></figure><ul><li><strong>Encrypted Cloud Sync</strong> is for WebBrain Compass members. Supported provider keys, profile text, and memories are encrypted with your sync password before upload. WebBrain cannot recover that password. Chat history and OAuth sign-ins are not synced.</li><li><strong>Profile auto-fill</strong> is a reusable block of personal details. It is stored in plaintext in this browser profile and sent to the active provider when enabled.</li><li><strong>User memory</strong> stores durable preferences. Explicit <code>/memory --add</code> saves immediately. Auto-learn and learning from completed forms are optional.</li></ul><div class="callout danger"><strong class="callout-title">Do not turn memory into a password manager</strong><p>Do not store passwords, API keys, tokens, recovery codes, or other secrets in profile text or user memory.</p></div></section>
<section class="doc-section" id="skills"><div class="eyebrow">Trust decision</div><h2>Skills: extra instructions and tools</h2><p>A skill can add instructions to the system prompt. A skill containing a <code>webbrain-tools</code> manifest can also expose HTTP or download-job tools. Imported skill text is copied into browser local storage and sent to your configured LLM as part of the system prompt.</p><p>The Skills tab lists your enabled skills first and then the packaged skills you can enable. <strong>Add skill</strong> opens the form for importing a skill from a URL or pasting its text; <strong>Edit</strong> on an enabled skill opens the same form with that skill loaded.</p><div class="callout warning"><strong class="callout-title">Importing is approval</strong><p>Only import a skill you trust. Its declared HTTPS tools can send their declared inputs to the declared endpoint without a new prompt for every call. Download tools still use the normal Downloads permission gate before saving a file.</p></div></section>
<section class="doc-section" id="captcha"><div class="eyebrow">When needed</div><h2>CAPTCHA: solver accounts</h2><p>The CAPTCHA tab holds CapSolver, 2Captcha, CapMonster Cloud, SolveCaptcha, Anti-Captcha, NopeCHA and NoneCap, each with its own card. Entering a key checks its enabled box; you can turn it off while keeping the key. Save persists that choice. Testing a balance does not enable solving.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-captcha.jpg"><img src="/docs/assets/screenshots/settings-captcha.jpg" alt="WebBrain CAPTCHA settings with one card per solver service"></a><figcaption>Nothing is enabled until you save a key. Testing a balance does not enable solving.</figcaption></figure><p>Expand a provider’s Advanced section to adjust its weight. Defaults are 100 through 94 in the order above. Enable any number; compatible providers run from highest weight to lowest. Errors and timeouts can cause more than one service to charge.</p><p>hCaptcha uses NopeCHA or NoneCap. Other families have provider-specific coverage and input requirements. See the <a href="/docs/captcha/">CAPTCHA guide</a> for the full coverage table, fallback behavior, privacy and page-application limits.</p></section>
<section class="doc-section" id="advanced"><div class="eyebrow">Expert tab</div><h2>Advanced: open it for a reason</h2><p>Advanced is its own tab. Use the search box to jump straight to a control; it searches Advanced together with General, Budgets and CAPTCHA.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-advanced.jpg"><img src="/docs/assets/screenshots/settings-advanced.jpg" alt="WebBrain Advanced settings with Help Improve WebBrain, Record traces and local feedback diagnostics"></a><figcaption>Each control keeps its full explanation next to it.</figcaption></figure>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Leave it…</th><th>Change it when…</th></tr></thead><tbody><tr><td>Record traces</td><td>Off</td><td>You are comparing models or diagnosing a run and accept local trace storage. One switch records each run with its full request details: prompts, messages, tool schemas and results.</td></tr><tr><td>Screenshot fallback</td><td>On if your model can see images</td><td>DOM reading misses canvas, charts, or visually rendered content.</td></tr><tr><td>Screenshot redaction</td><td>Off</td><td>You want WebBrain to blur form fields and text that looks like personal data before screenshots reach a vision model. It is best-effort, not a guarantee.</td></tr><tr><td>Site adapters</td><td>On</td><td>You are debugging token use or want to disable site-specific guidance.</td></tr><tr><td>Voice input</td><td>On</td><td>You do not want the microphone affordance.</td></tr><tr><td>API mutation observer</td><td>Off</td><td>You are investigating repeated UI actions and API shortcut suggestions.</td></tr><tr><td>Strict secret handling</td><td>Off for ordinary personal use</td><td>You screen-share or export traces and never want credentials quoted.</td></tr><tr><td>Allow local network</td><td>Off</td><td>The agent must reach localhost, an intranet, or a self-hosted private address.</td></tr></tbody></table></div>
</section>
<section class="doc-section" id="providers"><div class="eyebrow">Everyday</div><h2>Providers: choose the brain</h2><p>Providers is a page of its own. Open it from <strong>More…</strong> in the side panel’s model menu or from the <strong>Providers</strong> link at the top of Settings. Its first tab, <strong>LLM</strong>, lists the chat providers; the other tabs hold the helper models described below.</p><p>Only one provider is active at a time. Filter the list by Local, Cloud, or Router; search by provider, model, or field; then open a card to edit it. The safe sequence is <strong>Save → Test Connection → Set Active</strong>.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-providers.jpg"><img src="/docs/assets/screenshots/settings-providers.jpg" alt="WebBrain Providers page, LLM tab, with category filters, search and the active provider card"></a><figcaption>The active provider remains visible even when category filters are applied. Example model names are illustrative.</figcaption></figure><p>See <a href="/docs/providers/">Providers & models</a> for local server URLs, context windows, prompt tiers, and troubleshooting.</p></section>
<section class="doc-section" id="multimodal"><div class="eyebrow">When needed</div><h2>Vision, speech and decision models: support the main agent</h2><p>Choose the main conversation model on the <strong>LLM</strong> tab of the Providers page. The page’s other tabs hold optional helper models: <strong>Vision</strong>, <strong>Speech</strong>, <strong>Generative</strong> (images and video), <strong>Decision</strong> and <strong>SafeSocial</strong>. Configuring one does not change your active provider.</p><p>Vision and Decision models both default to <strong>Auto</strong>. In Chrome with hardware WebGPU, Auto uses <strong>Compass VLD Tiny v5</strong> (about 2.2 GB, runs on your device) once it is downloaded, and nothing before that; while WebBrain Cloud is active, Compass’s managed decision model answers decisions until then. The <strong>Download a local model</strong> button on the install page, <strong>Providers → WebGPU</strong>, the Vision card and Apocalypse Mode all download that same model, so one download covers chat, screenshots and decisions.</p>
<h3>Vision</h3><p>Pick what reads screenshots. An OpenAI-compatible endpoint, if you save one, reads every screenshot while the active provider keeps planning and tool calls. Without one, the active model reads screenshots itself if it can see images; if it cannot, the in-browser vision model does (Chrome only). Leave everything at its default to let the active provider handle vision. Screenshot limits are in Settings → Budgets and redaction in Settings → Advanced.</p><p>The in-browser vision model has five settings:</p><ul><li><strong>Auto</strong> (default): uses Compass VLD Tiny v5 once it is downloaded, Ternary Bonsai 2 2B Vision when only that one is, and stays off until then.</li><li><strong>Compass VLD Tiny v5</strong>: about 2.2 GB. The same model also chats and answers decisions.</li><li><strong>Ternary Bonsai 2 2B Vision</strong>: about 1.45 GB. The same model also chats.</li><li><strong>WebBrain VL 2 450M</strong>: about 810 MB, vision only. Its first download asks for your consent and checks WebGPU.</li><li><strong>Off</strong>: no in-browser vision model.</li></ul><p>Changing the setting never downloads anything; use the card’s <strong>Download</strong> button. Tasks never wait for a download, and screenshots read in the browser stay on your device. Firefox has no in-browser vision model.</p><figure class="shot"><a href="/docs/assets/screenshots/providers-vision.jpg"><img src="/docs/assets/screenshots/providers-vision.jpg" alt="Vision tab of the Providers page: the in-browser vision model set to Auto and the optional OpenAI-compatible endpoint"></a><figcaption>A fresh install: the in-browser vision model is on Auto and stays off until Compass VLD Tiny v5 is downloaded.</figcaption></figure>
<h3>Speech</h3><p>Configure a Whisper-compatible endpoint for recordings. Leave it blank and WebBrain tries configured providers in this order: OpenAI, Groq, LM Studio, then llama.cpp.</p>
<h3>Generative</h3><p>Connect fal.ai, OpenRouter, ComfyRouter or a local ComfyUI server for the image and video generation tool. Nothing is configured by default.</p>
<h3>Decision</h3><p>A decision model is a small, fast model that answers the agent’s yes-or-no and multiple-choice questions, such as “Is this task finished?”, so your chat model doesn’t have to. It never plans, clicks or types. Choose one mode:</p><ul><li><strong>Auto</strong> (default): nothing to set up. In Chrome it uses Compass VLD Tiny v5 once it is downloaded, to check whether side panel tasks and scheduled watches and tasks really finished, and D1 when only D1 is downloaded. While WebBrain Cloud (Compass) is your chat provider, Compass’s decision model answers until one of them is downloaded. Otherwise no decision model is used. The card shows which one is in use.</li><li><strong>On</strong>: uses the provider you set up for every decision: OpenRouter, TypeSafe, a local System One server, D1, or the in-browser chat model in Chrome. All decisions are on by default. Open <strong>Choose which decisions use it</strong> to turn off individual ones (Verify completion, Verify scheduled watches, Verify scheduled task completion, Fast classifications, Fast browser actions — Experimental) and to set thresholds.</li><li><strong>Off</strong>: never uses a decision model, Compass’s included. Your chat model still checks whether tasks are finished.</li></ul><p>A mode change applies at once; On’s provider fields use <strong>Save</strong>. <strong>Test Connection</strong> sends one request with fixed example data. <strong>Reset</strong> returns to Auto and deletes saved decision keys. Cloud decision providers receive limited task and page data and may cost money; Strict Secret Mode disables decision models. Profiles that had decision outsourcing turned on before these modes keep working as On with their previous switches.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-decision-models.jpg"><img src="/docs/assets/screenshots/settings-decision-models.jpg" alt="Decision models settings with Auto selected and the status line showing that no decision model is in use yet"></a><figcaption>Auto on a fresh install: nothing is downloaded yet, so no decision model is in use (unless WebBrain Cloud is your active provider, which uses Compass’s decision model). Provider fields appear only with On.</figcaption></figure>
<h3>SafeSocial</h3><p>An optional on-device image classifier for Instagram feeds. It is off until you turn it on; the model downloads once and runs in the browser.</p>
</section>
<section class="doc-section" id="permissions"><div class="eyebrow">Everyday safety</div><h2>Permissions: where WebBrain may act</h2><p>Permissions is a page of its own. Keep <strong>Ask before consequential actions</strong> on. When you choose “Always allow” in the side panel, WebBrain records a specific capability for a specific site, and the Permissions page lists it. A click grant is not automatically a typing, download, upload, JavaScript, or scheduling grant.</p><p>The same switch sits in the side panel: the <strong>⚠</strong> button next to the microphone in the message box opens it, with a link to the Permissions page. While prompts are off, that button stays orange with a dot. Switching prompts off there never approves a permission card that is already waiting; answer that card yourself.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-permissions.jpg"><img src="/docs/assets/screenshots/settings-permissions.jpg" alt="WebBrain Permissions page with the master safety switch and per-site capability grants"></a><figcaption>Revoke one capability to make WebBrain ask again next time, or clear the whole list.</figcaption></figure><div class="callout danger"><strong class="callout-title">The master switch is global</strong><p>Turning it off allows prompt-free actions on every site until you turn it back on. This is much broader than granting one capability to one host.</p></div></section>
<nav class="next-links" aria-label="Next guides"><a href="/docs/providers/"><span>Next</span>Providers & models →</a><a href="/docs/safety/"><span>Also important</span>Modes, safety & privacy →</a></nav>
</main>
<aside class="on-this-page" aria-label="On this page"><h2>On this page</h2><a href="#defaults">Good defaults</a><a href="#general">General</a><a href="#budgets">Budgets</a><a href="#memory">Memory</a><a href="#skills">Skills</a><a href="#captcha">CAPTCHA</a><a href="#advanced">Advanced</a><a href="#providers">Providers</a><a href="#multimodal">Vision, speech & decision</a><a href="#permissions">Permissions</a></aside>
</div>
<!-- Site footer: start -->
<footer class="wb-footer">
<div class="wb-footer-inner">
<div class="wb-footer-brand">
<p class="wb-footer-tagline">On a mission to make the web smarter.</p>
<p class="wb-footer-copy">© 2026 WebBrain. Built by <a href="https://emresokullu.com" target="_blank">Emre Sokullu</a> & <a href="https://github.com/webbrain-one/webbrain/graphs/contributors" target="_blank">contributors</a>.</p>
</div>
<div class="wb-footer-row">
<div class="wb-footer-links">
<a href="/">Browser extension</a>
<a href="/companion/">Desktop Companion</a>
<a href="/research/">Research</a>
<a href="/docs/">Docs</a>
<a href="/docs/faq/">FAQ</a>
<a href="/blog/">Blog</a>
<a href="/privacy">Privacy Policy</a>
<a href="https://github.com/webbrain-one/webbrain/issues" target="_blank" rel="noopener">Report Bug</a>
<a href="https://github.com/webbrain-one/webbrain/blob/main/LICENSE" target="_blank" rel="noopener">GPL-3.0 License</a>
<a href="https://pressreleases.online/org/webbrain.one" target="_blank" rel="noopener">Press</a>
<a href="https://api.webbrain.one/account" target="_blank" rel="noopener">Compass Subscription</a>
</div>
<div class="wb-footer-social">
<a href="https://mastoturk.org/@webbrain" target="_blank" rel="me noopener" aria-label="WebBrain on Mastodon" title="WebBrain on Mastodon" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M21.327 8.566c0-5.035-3.298-6.511-3.298-6.511C16.366 1.292 13.508.971 12.04.947h-.036c-1.468.024-4.326.345-5.989 1.108 0 0-3.298 1.476-3.298 6.511 0 1.153-.022 2.535.014 4.001.12 4.935.907 9.799 5.478 11.007 2.106.557 3.916.674 5.374.594 2.645-.147 4.128-.943 4.128-.943l-.087-1.918s-1.888.595-4.012.523c-2.104-.072-4.326-.227-4.668-2.809a5.289 5.289 0 0 1-.047-.724s2.066.505 4.686.625c1.603.073 3.107-.094 4.632-.276 2.925-.349 5.474-2.149 5.794-3.793.503-2.591.462-6.287.462-6.287ZM8.545 15.023H6.09V8.996c0-2.534 1.627-3.829 3.424-3.829 1.963 0 2.909 1.268 3.35 2.257.44-.989 1.386-2.257 3.349-2.257 1.797 0 3.424 1.295 3.424 3.829v6.027h-2.454V9.174c0-1.233-.519-1.859-1.557-1.859-1.148 0-1.724.742-1.724 2.207v3.203h-2.454V9.522c0-1.465-.576-2.207-1.724-2.207-1.038 0-1.557.626-1.557 1.859v5.849Z"/></svg></a>
<a href="https://bsky.app/profile/webbrain-one.bsky.social" target="_blank" rel="me noopener" aria-label="WebBrain on Bluesky" title="WebBrain on Bluesky" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12 10.8c-1.1-2.1-4-6-6.8-8C2.6.9 1.6 1.3.9 1.6.1 1.9 0 3.1 0 3.8c0 .7.4 5.7.6 6.5.8 2.7 3.7 3.7 5.6 3.4-3.5.6-6.5 2-2.5 6.5 4.3 4.5 5.9-1 6.3-2.8.1-.5.2-.8.3-.8.1 0 .2.3.3.8.4 1.8 2 7.3 6.3 2.8 4-4.5 1-5.9-2.5-6.5 1.9.3 4.8-.7 5.6-3.4.2-.8.6-5.8.6-6.5 0-.7-.1-1.9-.9-2.2-.7-.3-1.7-.6-4.3 1.2-2.8 2-5.7 5.9-6.8 8Z"/></svg></a>
<a href="https://discord.gg/cgC325ssfw" target="_blank" rel="noopener" aria-label="WebBrain on Discord" title="WebBrain on Discord" class="wb-footer-icon"><svg viewBox="0 0 16 16" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M13.545 2.907a13.227 13.227 0 0 0-3.257-1.011c.05.069.098.137.142.207a12.471 12.471 0 0 0-3.616 0c.044-.07.093-.138.143-.207A13.207 13.207 0 0 0 3.7 2.907 13.136 13.136 0 0 0 .931 13.362a13.667 13.667 0 0 0 4.022 2.018c.33-.442.623-.907.87-1.396a8.95 8.95 0 0 1-1.37-.652c.114-.083.225-.171.33-.269a9.6 9.6 0 0 0 8.243 0c.108.09.218.18.33.269a8.923 8.923 0 0 1-1.37.652c.248.489.54.954.87 1.396a13.667 13.667 0 0 0 4.022-2.018 13.136 13.136 0 0 0-2.769-10.455zM5.106 11.275c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608zm5.788 0c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608z"/></svg></a>
<a href="https://huggingface.co/webbrain-one" target="_blank" rel="me noopener" aria-label="WebBrain on Hugging Face" title="WebBrain on Hugging Face" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624"/></svg></a>
</div>
</div>
</div>
</footer>
<!-- Site footer: end --><script src="/docs/assets/docs.js?v=20260809"></script>
</body></html>