Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

21.2 KB
Raw Blame
<!doctype html>
<html lang="en" data-theme="dark">
<head>
  <meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Exports & saved workflows — WebBrain User Guide</title><meta name="description" content="Choose the right WebBrain export, teach reusable workflows by demonstration, and move saved workflows safely.">
  <link rel="canonical" href="https://webbrain.one/docs/formats/"><link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/formats/"><link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/formats/"><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/formats/" 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/">Modes, safety & privacy</a><a href="/docs/apocalypse-mode/">Apocalypse Mode</a><a href="/docs/formats/" aria-current="page">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/export-and-workflow-formats.md">Format reference ↗</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> / Exports & saved workflows</div>
      <section class="doc-hero"><div class="eyebrow">Portable, with boundaries</div><h1>Choose an export—or teach a workflow—by what you need to reuse.</h1><p class="lede">A readable conversation, a diagnostic trace, a Settings backup, and a reusable workflow are different artifacts. The safest choice is the narrowest one that fits your goal; when you already know the steps, Teacher mode can learn them from one manual demonstration.</p></section>

      <section class="doc-section" id="choose"><h2>Which export or workflow path should I use?</h2><div class="table-wrap"><table><thead><tr><th>Goal</th><th>Command</th><th>Result</th></tr></thead><tbody><tr><td>Save the visible conversation</td><td><code>/export</code></td><td>A readable Markdown transcript.</td></tr><tr><td>Debug a recorded agent run</td><td><code>/export --traces</code></td><td>Markdown with model responses, tool calls, arguments, and results.</td></tr><tr><td>Back up or move Settings</td><td><code>/export --config</code></td><td>A <code>webbrain-config/1</code> JSON snapshot.</td></tr><tr><td>Learn a workflow by doing it once</td><td><code>/teach --start &lt;name&gt;</code></td><td>A value-free saved workflow compiled from your manual demonstration.</td></tr><tr><td>Move one reusable automation</td><td><code>/workflow --export &lt;id&gt;</code></td><td>A sanitized <code>webbrain-workflow/1</code> JSON definition.</td></tr></tbody></table></div><div class="callout warning"><strong class="callout-title">Configuration exports contain plaintext secrets</strong><p>A Settings snapshot can include provider API keys, profile data, user memory, custom skills, and permission choices. Store it like a password backup; do not attach it to a public issue.</p></div></section>

      <section class="doc-section" id="conversation"><h2>Conversation and trace Markdown</h2><p><code>/export</code> captures the messages currently shown in the side panel and records the exporting WebBrain version. It is designed for reading, not for importing back into WebBrain.</p><p><code>/export --traces</code> uses locally recorded traces for the current conversation. It can include prompts, model output, URLs, tool arguments, and tool results. Screenshots are omitted from this Markdown file. If tracing was off when a turn ran, that turn cannot be reconstructed later.</p><div class="callout tip"><strong class="callout-title">Sharing a bug report?</strong><p>Start with the conversation export. Use the trace export only when tool-level detail is needed, and review either file for personal data first.</p></div></section>

      <section class="doc-section" id="config"><h2>Back up Settings</h2><ol><li>Enter <code>/export --config</code>.</li><li>Store the downloaded <code>webbrain-config-….json</code> securely.</li><li>Restore it with <code>/import --file</code>, or paste its JSON after <code>/import</code>.</li></ol><p>The snapshot includes portable Settings values. It does not include conversations, traces, schedules, usage counters, accumulated spend, or device-bound Cloud Sync sessions and device IDs.</p><p>The <code>schema</code> value identifies compatibility. WebBrain currently exports and accepts <code>webbrain-config/1</code>.</p></section>

      <section class="doc-section" id="teach"><div class="eyebrow">Learn by demonstration</div><h2>Teach WebBrain a workflow by doing it once</h2><p>Use Teacher mode when you know the browser steps and want to save them without first asking the agent to complete a traced run. The demonstration is tab-scoped and compiles into the same guarded <code>webbrain-workflow/1</code> format as <code>/workflow --save</code>.</p><ol class="step-list"><li><strong>Open the starting page.</strong> Use a regular <code>http(s)</code> page and stop any agent run that currently owns the tab.</li><li><strong>Start teaching.</strong> Enter <code>/teach --start &lt;name&gt;</code>. A purple WebBrain Teach indicator appears on the page.</li><li><strong>Perform the workflow manually.</strong> In that tab, make the trusted clicks, complete fields, change checkboxes or radio buttons, submit with Enter, and navigate exactly as the reusable flow should.</li><li><strong>Check progress when useful.</strong> Enter <code>/teach</code> to see the active workflow name and captured action count.</li><li><strong>Compile and save.</strong> Enter <code>/teach --end</code>. Then open <code>/workflow</code> to run, rename, export, or delete the learned workflow.</li></ol><div class="callout tip"><strong class="callout-title">Typed values are never learned</strong><p>The page capture code records a field’s semantic identity, not its contents. Each completed field becomes a runtime parameter, and WebBrain asks for the current value locally whenever the saved workflow runs.</p></div><h3>Capture boundaries</h3><ul><li>Only trusted actions in the top-level page are captured; actions performed by WebBrain itself are excluded.</li><li>The session follows navigation in the same tab and records at most 100 normalized actions.</li><li>Teacher mode and automated agent runs cannot own the same tab at the same time. Finish with <code>/teach --end</code> before starting an agent task.</li><li>Unsupported or unsafe targets are skipped. The save result reports warnings and replay still requires an unambiguous semantic match.</li><li><code>/teach --end</code> closes the temporary teaching session even when compilation cannot produce a workflow, so correct the page or demonstration and start again.</li></ul></section>

      <section class="doc-section" id="workflow"><h2>Create from a trace, then move a saved workflow</h2><p>Teacher mode is the manual-demonstration path. If the agent already completed the task successfully with tracing enabled, save that execution instead:</p><ol><li>Enable tracing and complete the task successfully.</li><li>Save it with <code>/workflow --save &lt;name&gt;</code>.</li><li>Run <code>/workflow</code> to find its ID.</li><li>Download it with <code>/workflow --export &lt;id&gt;</code>.</li><li>On another WebBrain installation, use <code>/workflow --import --file</code>.</li></ol><p>Need to inspect or update an exported workflow file? Use the <a href="https://www.webbrain.one/workflow-editor">WebBrain Workflow Editor</a> locally in your browser.</p><p>A portable workflow is not the original trace or teaching session. WebBrain removes old element references, CSS selectors, click coordinates, URL query strings and fragments, and typed field values. Typed values become prompts that are collected locally each time the workflow runs.</p><p>The file keeps semantic target descriptions and origin/path scopes so WebBrain can find the current element and fail closed when a match is ambiguous. Normal Act permissions, submission confirmation, and result verification still apply.</p><div class="callout"><strong class="callout-title">Import creates a copy</strong><p>WebBrain assigns a fresh local ID and timestamps instead of overwriting an existing workflow. Portable workflow files are limited to 1 MiB.</p></div></section>

      <section class="doc-section" id="sharing"><h2>Review before sharing</h2><div class="table-wrap"><table><thead><tr><th>File</th><th>Minimum review</th></tr></thead><tbody><tr><td>Conversation Markdown</td><td>Messages and system notices.</td></tr><tr><td>Trace Markdown or Trace-page JSON</td><td>Prompts, URLs, arguments, results, and any embedded screenshots.</td></tr><tr><td>Settings JSON</td><td>Do not share unless you have intentionally removed every secret and private value.</td></tr><tr><td>Workflow JSON</td><td>Name, source metadata, site origins/path families, target labels, and step intent.</td></tr></tbody></table></div><p>For the complete field-level formats and compatibility rules, see the <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/export-and-workflow-formats.md">technical format reference</a>.</p></section>

      <nav class="next-links" aria-label="Next guides"><a href="/docs/safety/"><span>Related</span>← Modes, safety & privacy</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="#choose">Choose a path</a><a href="#conversation">Conversation & traces</a><a href="#config">Settings backup</a><a href="#teach">Teacher mode</a><a href="#workflow">Saved workflows</a><a href="#sharing">Share safely</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> &amp; <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>