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>Modes, safety & privacy — WebBrain User Guide</title><meta name="description" content="Understand WebBrain Ask, Act and Dev modes, permission prompts, privacy boundaries, memory and advanced overrides.">
<link rel="canonical" href="https://webbrain.one/docs/safety/"><link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/safety/"><link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/safety/"><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/safety/" 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/">Settings, explained</a><a href="/docs/providers/">Providers & models</a><a href="/companion/">WebBrain Companion</a><a href="/docs/safety/" aria-current="page">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/blob/main/docs/security-model.md">Security model ↗</a><a href="https://github.com/webbrain-one/webbrain/blob/main/docs/privacy-and-data-flow.md">Privacy & data flow ↗</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> / Modes, safety & privacy</div>
<section class="doc-hero"><div class="eyebrow">Human in the loop</div><h1>WebBrain works inside your logged-in browser. Treat that access with care.</h1><p class="lede">The agent can see and use the same websites you can. Modes, plan review, and per-site permissions reduce risk, but you remain responsible for the prompt, destination, and outcome.</p></section>
<section class="doc-section" id="modes"><h2>Modes set the kind of work</h2><div class="mode-strip"><div class="mode ask"><strong>Ask</strong><span>Semantic reading and research tools. No clicking, typing, navigation, uploads, or page mutation.</span></div><div class="mode act"><strong>Act</strong><span>Normal browser actions for tasks you explicitly request. Consequential actions still meet the permission gate.</span></div><div class="mode dev"><strong>Dev</strong><span>Act plus source, style, DOM, frame, and debugging tools. Requires a Mid or Full provider.</span></div></div><p>Use Ask whenever the result can be produced by reading. Switch to Act only when the requested outcome requires changing a page. Use Dev for web development and troubleshooting—not as a way to make a weak model smarter.</p></section>
<section class="doc-section" id="permissions"><h2>Permission prompts are capability-specific</h2><p>Before a consequential action on a site, WebBrain can ask whether to allow it once, always allow that capability on that host, or deny it. The remembered record is a pair: <strong>site + capability</strong>.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-permissions.jpg"><img src="/docs/assets/screenshots/settings-permissions.jpg" alt="Permission settings showing a global safety switch and separate grants for scheduling, clicking and typing"></a><figcaption>Separate grants mean you can allow typing on a site without automatically allowing downloads, uploads, JavaScript, or future scheduling.</figcaption></figure><div class="table-wrap"><table><thead><tr><th>Choice</th><th>Use it when</th><th>What happens later</th></tr></thead><tbody><tr><td>Allow once</td><td>The action is reasonable but you do not want a standing grant.</td><td>WebBrain asks again the next time it needs that capability.</td></tr><tr><td>Always allow on host</td><td>You trust that site and expect the same action type repeatedly.</td><td>The matching site + capability record appears on the Permissions page.</td></tr><tr><td>Don’t allow</td><td>The action, destination, or timing is wrong.</td><td>The action is blocked. You stay in control of the run.</td></tr></tbody></table></div></section>
<section class="doc-section" id="page-content"><h2>Pages are untrusted—even familiar pages</h2><p>A page can contain text written to manipulate an AI agent. WebBrain wraps page-derived content as untrusted data and limits the action surface with modes and permissions. Those defenses reduce risk; they do not make every model or page safe.</p><ul><li>Stop if the agent follows instructions you did not give.</li><li>Be cautious on health, finance, dating, private account, and internal work pages.</li><li>Review destinations and form values before a submission.</li><li>Avoid unattended Act-mode work on pages whose content can be edited by strangers.</li></ul><div class="callout danger"><strong class="callout-title">Your LLM provider is inside the trust boundary</strong><p>The configured provider receives the conversation and the page-derived content WebBrain sends for the task. Use a provider whose privacy terms and operation you accept.</p></div></section>
<section class="doc-section" id="overrides"><h2>Two overrides that are easy to confuse</h2><div class="table-wrap"><table><thead><tr><th>Override</th><th>Scope</th><th>What it changes</th></tr></thead><tbody><tr><td><code>/allow-api</code></td><td>Current conversation</td><td>Allows write-method network egress—POST, PUT, PATCH, DELETE—when the agent judges an API path more reliable. It clears on reset and does not waive every other permission.</td></tr><tr><td><code>/dangerously-skip-permissions</code></td><td>Global until re-enabled</td><td>Turns off “Ask before consequential actions” for all sites and capabilities.</td></tr></tbody></table></div><div class="callout warning"><strong class="callout-title">Prefer the narrowest decision</strong><p>If one site and one action are trusted, grant that capability in the normal prompt. Do not disable the global permission gate just to avoid one confirmation.</p></div></section>
<section class="doc-section" id="memory"><h2>What stays in the browser—and what may leave it</h2><div class="table-wrap"><table><thead><tr><th>Data</th><th>Stored where</th><th>Sent when</th></tr></thead><tbody><tr><td>Conversation history</td><td>Browser local storage / IndexedDB</td><td>Relevant conversation context is sent to the active LLM provider during a turn.</td></tr><tr><td>Provider settings & API keys</td><td>Browser local storage, plaintext</td><td>Keys are sent to their provider to authenticate requests.</td></tr><tr><td>Profile auto-fill</td><td>Browser local storage, plaintext</td><td>Sent to the active provider as system-prompt context when enabled.</td></tr><tr><td>User memory</td><td>Browser local storage, plaintext</td><td>Active records are sent to the active provider as system-prompt context.</td></tr><tr><td>Traces & screenshots</td><td>Local IndexedDB when tracing is enabled</td><td>Not uploaded by the trace recorder. Export creates a local file.</td></tr><tr><td>Encrypted cloud sync</td><td>Opaque encrypted cloud copy plus local data</td><td>Supported keys, profile, and memory are encrypted before upload. The sync password is never sent or stored.</td></tr></tbody></table></div><p>WebBrain itself does not add general telemetry for agent conversations. A provider still sees the data included in its model request, and any site you act on sees the browser actions and submissions performed there.</p></section>
<section class="doc-section" id="scheduled"><h2>Scheduled tasks deserve stricter defaults</h2><p>A scheduled task can run when you are not watching. Keep <strong>Confirm scheduled consequential actions</strong> on so the run pauses before actions that need permission. If a task depends on changing page state, make the target URL, timing, expected result, and stop conditions explicit.</p><div class="callout tip"><strong class="callout-title">A safer scheduled prompt</strong><p>“At 9:00, open this dashboard, read the new status, and summarize it. Do not submit, acknowledge, or edit anything.” The boundary is as important as the task.</p></div></section>
<section class="doc-section" id="checklist"><h2>Before an important Act run</h2><ol><li>Confirm the active provider and model.</li><li>Use a fresh conversation for a clearly scoped task.</li><li>Keep plan review and the permission gate on.</li><li>Name actions the agent must not take.</li><li>Stay available for permission and clarification prompts.</li><li>Stop on unexpected navigation, credential handling, or repetition.</li><li>Verify the real-world result; do not rely only on the final summary.</li></ol></section>
<nav class="next-links" aria-label="Next guides"><a href="/docs/providers/"><span>Back</span>← Providers & models</a><a href="/docs/"><span>Start over</span>Guide overview →</a></nav>
</main>
<aside class="on-this-page" aria-label="On this page"><h2>On this page</h2><a href="#modes">Modes</a><a href="#permissions">Permissions</a><a href="#page-content">Untrusted pages</a><a href="#overrides">Overrides</a><a href="#memory">Data & memory</a><a href="#scheduled">Scheduled tasks</a><a href="#checklist">Checklist</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>