npm - zubo - Versions diffs - 0.1.0 - Mend

zubo 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (222) hide show

package/.github/workflows/ci.yml +35 -0
package/README.md +149 -0
package/bun.lock +216 -0
package/desktop/README.md +57 -0
package/desktop/package.json +12 -0
package/desktop/src-tauri/Cargo.toml +25 -0
package/desktop/src-tauri/build.rs +3 -0
package/desktop/src-tauri/icons/README.md +17 -0
package/desktop/src-tauri/icons/icon.png +0 -0
package/desktop/src-tauri/src/main.rs +189 -0
package/desktop/src-tauri/tauri.conf.json +68 -0
package/docs/ROADMAP.md +490 -0
package/migrations/001_init.sql +9 -0
package/migrations/002_memory.sql +33 -0
package/migrations/003_cron.sql +24 -0
package/migrations/004_usage.sql +12 -0
package/migrations/005_secrets.sql +8 -0
package/migrations/006_agents.sql +1 -0
package/migrations/007_workflows.sql +22 -0
package/migrations/008_proactive.sql +24 -0
package/migrations/009_uploads.sql +9 -0
package/migrations/010_observability.sql +22 -0
package/migrations/011_api_keys.sql +7 -0
package/migrations/012_indexes.sql +5 -0
package/migrations/013_budget.sql +11 -0
package/migrations/014_usage_session_idx.sql +2 -0
package/package.json +39 -0
package/site/404.html +156 -0
package/site/CNAME +1 -0
package/site/docs/agents.html +294 -0
package/site/docs/api.html +446 -0
package/site/docs/channels.html +345 -0
package/site/docs/cli.html +238 -0
package/site/docs/config.html +1034 -0
package/site/docs/index.html +433 -0
package/site/docs/integrations.html +381 -0
package/site/docs/memory.html +254 -0
package/site/docs/security.html +375 -0
package/site/docs/skills.html +322 -0
package/site/docs.css +412 -0
package/site/index.html +638 -0
package/site/install.sh +98 -0
package/site/logo.svg +1 -0
package/site/og-image.png +0 -0
package/site/robots.txt +4 -0
package/site/script.js +361 -0
package/site/sitemap.xml +63 -0
package/site/skills.html +532 -0
package/site/style.css +1686 -0
package/src/agent/agents.ts +159 -0
package/src/agent/compaction.ts +53 -0
package/src/agent/context.ts +18 -0
package/src/agent/delegate.ts +118 -0
package/src/agent/loop.ts +318 -0
package/src/agent/prompts.ts +111 -0
package/src/agent/session.ts +87 -0
package/src/agent/teams.ts +116 -0
package/src/agent/workflow-executor.ts +192 -0
package/src/agent/workflow.ts +175 -0
package/src/channels/adapter.ts +21 -0
package/src/channels/dashboard.html.ts +2969 -0
package/src/channels/discord.ts +137 -0
package/src/channels/optional-deps.d.ts +17 -0
package/src/channels/router.ts +199 -0
package/src/channels/signal.ts +133 -0
package/src/channels/slack.ts +101 -0
package/src/channels/telegram.ts +102 -0
package/src/channels/utils.ts +18 -0
package/src/channels/webchat.ts +1797 -0
package/src/channels/whatsapp.ts +119 -0
package/src/config/loader.ts +22 -0
package/src/config/paths.ts +43 -0
package/src/config/schema.ts +121 -0
package/src/db/connection.ts +20 -0
package/src/db/export.ts +148 -0
package/src/db/migrations.ts +42 -0
package/src/index.ts +261 -0
package/src/llm/claude.ts +193 -0
package/src/llm/factory.ts +115 -0
package/src/llm/failover.ts +101 -0
package/src/llm/openai-compat.ts +409 -0
package/src/llm/provider.ts +83 -0
package/src/llm/smart-router.ts +241 -0
package/src/logs.ts +53 -0
package/src/memory/chunker.ts +58 -0
package/src/memory/document-parser.ts +115 -0
package/src/memory/embedder.ts +235 -0
package/src/memory/engine.ts +170 -0
package/src/memory/fts-index.ts +55 -0
package/src/memory/hybrid-search.ts +72 -0
package/src/memory/store.ts +56 -0
package/src/memory/vector-index.ts +72 -0
package/src/model.ts +118 -0
package/src/registry/cli.ts +43 -0
package/src/registry/client.ts +54 -0
package/src/registry/installer.ts +67 -0
package/src/scheduler/briefing.ts +71 -0
package/src/scheduler/cron.ts +258 -0
package/src/scheduler/heartbeat.ts +58 -0
package/src/scheduler/memory-triggers.ts +100 -0
package/src/scheduler/natural-cron.ts +163 -0
package/src/scheduler/proactive.ts +25 -0
package/src/scheduler/recipes.ts +110 -0
package/src/secrets/store.ts +64 -0
package/src/setup.ts +413 -0
package/src/skills.ts +293 -0
package/src/start.ts +373 -0
package/src/status.ts +165 -0
package/src/tools/builtin/connect-service.ts +205 -0
package/src/tools/builtin/cron.ts +126 -0
package/src/tools/builtin/datetime.ts +36 -0
package/src/tools/builtin/delegate-task.ts +81 -0
package/src/tools/builtin/delegate.ts +42 -0
package/src/tools/builtin/diagnose.ts +41 -0
package/src/tools/builtin/google-oauth.ts +379 -0
package/src/tools/builtin/manage-agents.ts +149 -0
package/src/tools/builtin/manage-skills.ts +294 -0
package/src/tools/builtin/manage-teams.ts +89 -0
package/src/tools/builtin/manage-triggers.ts +94 -0
package/src/tools/builtin/manage-workflows.ts +119 -0
package/src/tools/builtin/memory-search.ts +38 -0
package/src/tools/builtin/memory-write.ts +30 -0
package/src/tools/builtin/run-workflow.ts +36 -0
package/src/tools/builtin/secrets.ts +122 -0
package/src/tools/builtin/skill-registry.ts +75 -0
package/src/tools/builtin-integrations/api-helpers.ts +26 -0
package/src/tools/builtin-integrations/github/github_issues/SKILL.md +56 -0
package/src/tools/builtin-integrations/github/github_issues/handler.ts +108 -0
package/src/tools/builtin-integrations/github/github_prs/SKILL.md +57 -0
package/src/tools/builtin-integrations/github/github_prs/handler.ts +113 -0
package/src/tools/builtin-integrations/github/github_repos/SKILL.md +37 -0
package/src/tools/builtin-integrations/github/github_repos/handler.ts +88 -0
package/src/tools/builtin-integrations/google/gmail/SKILL.md +51 -0
package/src/tools/builtin-integrations/google/gmail/handler.ts +125 -0
package/src/tools/builtin-integrations/google/google_calendar/SKILL.md +35 -0
package/src/tools/builtin-integrations/google/google_calendar/handler.ts +105 -0
package/src/tools/builtin-integrations/google/google_docs/SKILL.md +35 -0
package/src/tools/builtin-integrations/google/google_docs/handler.ts +108 -0
package/src/tools/builtin-integrations/google/google_drive/SKILL.md +39 -0
package/src/tools/builtin-integrations/google/google_drive/handler.ts +106 -0
package/src/tools/builtin-integrations/google/google_sheets/SKILL.md +36 -0
package/src/tools/builtin-integrations/google/google_sheets/handler.ts +116 -0
package/src/tools/builtin-integrations/jira/jira_boards/SKILL.md +21 -0
package/src/tools/builtin-integrations/jira/jira_boards/handler.ts +74 -0
package/src/tools/builtin-integrations/jira/jira_issues/SKILL.md +28 -0
package/src/tools/builtin-integrations/jira/jira_issues/handler.ts +140 -0
package/src/tools/builtin-integrations/linear/linear_issues/SKILL.md +30 -0
package/src/tools/builtin-integrations/linear/linear_issues/handler.ts +75 -0
package/src/tools/builtin-integrations/linear/linear_projects/SKILL.md +21 -0
package/src/tools/builtin-integrations/linear/linear_projects/handler.ts +43 -0
package/src/tools/builtin-integrations/notion/notion_databases/SKILL.md +39 -0
package/src/tools/builtin-integrations/notion/notion_databases/handler.ts +83 -0
package/src/tools/builtin-integrations/notion/notion_pages/SKILL.md +43 -0
package/src/tools/builtin-integrations/notion/notion_pages/handler.ts +130 -0
package/src/tools/builtin-integrations/notion/notion_search/SKILL.md +27 -0
package/src/tools/builtin-integrations/notion/notion_search/handler.ts +69 -0
package/src/tools/builtin-integrations/slack/slack_messages/SKILL.md +42 -0
package/src/tools/builtin-integrations/slack/slack_messages/handler.ts +72 -0
package/src/tools/builtin-integrations/twitter/twitter_posts/SKILL.md +24 -0
package/src/tools/builtin-integrations/twitter/twitter_posts/handler.ts +133 -0
package/src/tools/builtin-skills/file-read/SKILL.md +26 -0
package/src/tools/builtin-skills/file-read/handler.ts +66 -0
package/src/tools/builtin-skills/file-write/SKILL.md +30 -0
package/src/tools/builtin-skills/file-write/handler.ts +64 -0
package/src/tools/builtin-skills/http-request/SKILL.md +34 -0
package/src/tools/builtin-skills/http-request/handler.ts +87 -0
package/src/tools/builtin-skills/shell/SKILL.md +26 -0
package/src/tools/builtin-skills/shell/handler.ts +96 -0
package/src/tools/builtin-skills/url-fetch/SKILL.md +26 -0
package/src/tools/builtin-skills/url-fetch/handler.ts +37 -0
package/src/tools/builtin-skills/web-search/SKILL.md +26 -0
package/src/tools/builtin-skills/web-search/handler.ts +50 -0
package/src/tools/executor.ts +205 -0
package/src/tools/integration-installer.ts +106 -0
package/src/tools/permissions.ts +45 -0
package/src/tools/registry.ts +39 -0
package/src/tools/sandbox-runner.ts +56 -0
package/src/tools/sandbox.ts +82 -0
package/src/tools/skill-installer.ts +52 -0
package/src/tools/skill-loader.ts +259 -0
package/src/types/optional-deps.d.ts +23 -0
package/src/util/auth.ts +121 -0
package/src/util/costs.ts +59 -0
package/src/util/error-buffer.ts +32 -0
package/src/util/google-tokens.ts +180 -0
package/src/util/logger.ts +73 -0
package/src/util/perf-collector.ts +35 -0
package/src/util/rate-limiter.ts +70 -0
package/src/util/tokens.ts +17 -0
package/src/voice/stt.ts +57 -0
package/src/voice/tts.ts +103 -0
package/tests/agent/session.test.ts +109 -0
package/tests/agent-loop.test.ts +54 -0
package/tests/auth.test.ts +89 -0
package/tests/channels.test.ts +67 -0
package/tests/compaction.test.ts +44 -0
package/tests/config.test.ts +51 -0
package/tests/costs.test.ts +19 -0
package/tests/cron.test.ts +55 -0
package/tests/db/export.test.ts +219 -0
package/tests/executor.test.ts +144 -0
package/tests/export.test.ts +137 -0
package/tests/helpers/mock-llm.ts +34 -0
package/tests/helpers/test-db.ts +74 -0
package/tests/integration/chat-flow.test.ts +48 -0
package/tests/integrations.test.ts +97 -0
package/tests/memory/engine.test.ts +114 -0
package/tests/memory-engine.test.ts +57 -0
package/tests/permissions.test.ts +21 -0
package/tests/rate-limiter.test.ts +70 -0
package/tests/registry.test.ts +67 -0
package/tests/router.test.ts +36 -0
package/tests/session.test.ts +58 -0
package/tests/skill-loader.test.ts +44 -0
package/tests/tokens.test.ts +30 -0
package/tests/tools/executor.test.ts +130 -0
package/tests/util/auth.test.ts +75 -0
package/tests/util/rate-limiter.test.ts +73 -0
package/tests/voice.test.ts +60 -0
package/tests/webchat.test.ts +88 -0
package/tests/workflow.test.ts +38 -0
package/tsconfig.json +16 -0

package/site/docs/config.html ADDED Viewed

@@ -0,0 +1,1034 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Configuration — Zubo Docs</title>
+  <meta name="description" content="Complete configuration reference for Zubo: LLM providers, channels, voice, rate limiting, authentication, sandbox settings, and full annotated example.">
+  <meta name="theme-color" content="#060608">
+  <link rel="canonical" href="https://zubo.bot/docs/config.html">
+  <meta property="og:title" content="Configuration — Zubo Docs">
+  <meta property="og:description" content="Complete configuration reference for Zubo: LLM providers, channels, voice, rate limiting, authentication, and sandbox settings.">
+  <meta property="og:type" content="article">
+  <meta property="og:url" content="https://zubo.bot/docs/config.html">
+  <meta property="og:image" content="https://zubo.bot/og-image.png">
+  <meta property="og:site_name" content="Zubo">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:title" content="Configuration — Zubo Docs">
+  <meta name="twitter:description" content="Complete configuration reference for Zubo: LLM providers, channels, voice, rate limiting, and authentication.">
+  <meta name="twitter:image" content="https://zubo.bot/og-image.png">
+  <meta name="twitter:creator" content="@thomaskanze">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,600;12..96,700;12..96,800&family=DM+Sans:ital,opsz,wght@0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700;1,9..40,400&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="../style.css">
+  <link rel="stylesheet" href="../docs.css">
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><rect width='100' height='100' rx='20' fill='%237c3aed'/><path d='M50 15C52 37 63 48 85 50C63 52 52 63 50 85C48 63 37 52 15 50C37 48 48 37 50 15Z' fill='white'/></svg>">
+</head>
+<body>
+  <header class="nav scrolled" id="nav">
+    <div class="nav-inner">
+      <a href="../index.html" class="nav-logo"><span class="logo-wordmark">zubo</span></a>
+      <nav class="nav-links" id="nav-links">
+        <a href="../index.html#features">Features</a>
+        <a href="index.html" style="color:#fff;">Docs</a>
+        <a href="../skills.html">Skills</a>
+        <a href="../index.html#get-started">Get Started</a>
+      </nav>
+      <div class="nav-right">
+        <a href="https://github.com/apwn/zubo" class="nav-github" aria-label="GitHub">
+          <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
+        </a>
+        <a href="../index.html#get-started" class="btn btn-primary btn-nav">Get Started</a>
+        <button class="nav-toggle" id="nav-toggle" aria-label="Toggle menu"><span></span><span></span><span></span></button>
+      </div>
+    </div>
+  </header>
+  <div class="docs-layout">
+    <aside class="docs-sidebar" id="docs-sidebar">
+      <div class="docs-sidebar-section">
+        <div class="docs-sidebar-heading">Getting Started</div>
+        <div class="docs-sidebar-links">
+          <a href="index.html">Overview</a>
+          <a href="config.html" class="active">Configuration</a>
+        </div>
+      </div>
+      <div class="docs-sidebar-section">
+        <div class="docs-sidebar-heading">Core Concepts</div>
+        <div class="docs-sidebar-links">
+          <a href="agents.html">Agents &amp; Workflows</a>
+          <a href="memory.html">Memory System</a>
+          <a href="skills.html">Skills</a>
+        </div>
+      </div>
+      <div class="docs-sidebar-section">
+        <div class="docs-sidebar-heading">Guides</div>
+        <div class="docs-sidebar-links">
+          <a href="channels.html">Channel Setup</a>
+          <a href="integrations.html">Integrations</a>
+          <a href="security.html">Security &amp; Auth</a>
+        </div>
+      </div>
+      <div class="docs-sidebar-section">
+        <div class="docs-sidebar-heading">Reference</div>
+        <div class="docs-sidebar-links">
+          <a href="api.html">API Reference</a>
+          <a href="cli.html">CLI Commands</a>
+        </div>
+      </div>
+    </aside>
+    <main class="docs-content">
+      <div class="docs-breadcrumb">
+        <a href="../index.html">Home</a> <span>/</span> <a href="index.html">Docs</a> <span>/</span> <span>Configuration</span>
+      </div>
+      <h1>Configuration</h1>
+      <p>
+        All Zubo configuration lives in a single file: <code>~/.zubo/config.json</code>. You can edit this file directly with any text editor, or use the <code>zubo config</code> CLI commands for quick changes without opening a file. Changes to the configuration file are picked up on the next restart, while CLI changes via <code>zubo config set</code> take effect immediately if Zubo is running.
+      </p>
+      <!-- ================================================================ -->
+      <h2 id="quick-config-via-cli">Quick Config via CLI</h2>
+      <p>The <code>zubo config</code> command provides a convenient way to read and write configuration values from the terminal:</p>
+<pre><code># Set values
+zubo config set activeProvider ollama
+zubo config set model llama3.3
+zubo config set heartbeatMinutes 60
+zubo config set auth.enabled true
+zubo config set rateLimit.chatPerMinute 30
+zubo config set channels.webchat.port 8080
+zubo config set providers.anthropic.model claude-sonnet-4-5-20250929
+# Get values
+zubo config get                    # Show entire configuration (pretty-printed)
+zubo config get activeProvider     # Show a single value
+zubo config get channels.telegram  # Show a nested object
+zubo config get rateLimit          # Show all rate limit settings</code></pre>
+      <p><strong>Notes on the CLI:</strong></p>
+      <ul>
+        <li>Supports <strong>dotted keys</strong> for nested values. <code>zubo config set channels.webchat.port 8080</code> writes to <code>{"channels": {"webchat": {"port": 8080}}}</code>.</li>
+        <li>Types are <strong>auto-detected</strong>: <code>true</code> and <code>false</code> become booleans, strings of digits become numbers, everything else stays a string.</li>
+        <li>To explicitly set a string that looks like a number, wrap it in quotes: <code>zubo config set someField '"12345"'</code>.</li>
+        <li>The <code>set</code> command writes the file atomically, so there is no risk of corruption from concurrent writes.</li>
+      </ul>
+      <!-- ================================================================ -->
+      <h2 id="llm-providers">LLM Providers</h2>
+      <p>
+        Zubo supports a multi-provider architecture. You configure one or more LLM providers under the <code>providers</code> object, set one as <code>activeProvider</code>, and optionally define a <code>failover</code> chain. If the active provider fails (network error, rate limit, authentication error), Zubo automatically tries each failover provider in order until one succeeds.
+      </p>
+      <h3>Supported Providers</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Provider Key</th>
+            <th>Default Base URL</th>
+            <th>Notes</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>anthropic</code></td>
+            <td><em>(uses Anthropic SDK directly)</em></td>
+            <td>Claude models. Supports up to 200k token context. Native streaming. Recommended primary provider.</td>
+          </tr>
+          <tr>
+            <td><code>openai</code></td>
+            <td><code>https://api.openai.com/v1</code></td>
+            <td>GPT-4o, GPT-4-turbo, and other OpenAI models. Streaming supported.</td>
+          </tr>
+          <tr>
+            <td><code>ollama</code></td>
+            <td><code>http://localhost:11434/v1</code></td>
+            <td>Run models locally. No API key required. Great as a failover for offline operation.</td>
+          </tr>
+          <tr>
+            <td><code>groq</code></td>
+            <td><code>https://api.groq.com/openai/v1</code></td>
+            <td>Extremely fast inference. Supports Llama, Mixtral, and other open models.</td>
+          </tr>
+          <tr>
+            <td><code>together</code></td>
+            <td><code>https://api.together.xyz/v1</code></td>
+            <td>Wide selection of open-source models. Competitive pricing.</td>
+          </tr>
+          <tr>
+            <td><code>openrouter</code></td>
+            <td><code>https://openrouter.ai/api/v1</code></td>
+            <td>Multi-model gateway. Access Claude, GPT-4, Llama, and more through a single API key.</td>
+          </tr>
+          <tr>
+            <td><code>lmstudio</code></td>
+            <td><code>http://localhost:1234/v1</code></td>
+            <td>Local model GUI. Download and run models with a graphical interface. No API key required.</td>
+          </tr>
+          <tr>
+            <td><code>google</code></td>
+            <td><code>https://generativelanguage.googleapis.com/v1beta</code></td>
+            <td>Google Gemini models. Supports Gemini Pro, Gemini Flash, and other Google AI models.</td>
+          </tr>
+          <tr>
+            <td><code>deepseek</code></td>
+            <td><code>https://api.deepseek.com/v1</code></td>
+            <td>DeepSeek models. OpenAI-compatible API with strong reasoning capabilities at competitive pricing.</td>
+          </tr>
+          <tr>
+            <td><code>xai</code></td>
+            <td><code>https://api.x.ai/v1</code></td>
+            <td>xAI Grok models. OpenAI-compatible API with real-time knowledge.</td>
+          </tr>
+          <tr>
+            <td><code>fireworks</code></td>
+            <td><code>https://api.fireworks.ai/inference/v1</code></td>
+            <td>Fireworks AI. Fast inference for open-source models with optimized serving.</td>
+          </tr>
+        </tbody>
+      </table>
+      <h3>Provider Configuration Fields</h3>
+      <p>Each provider object under <code>providers</code> accepts the following fields:</p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Required</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>apiKey</code></td>
+            <td>string</td>
+            <td>Yes*</td>
+            <td>API key for the provider. Not required for local providers (Ollama, LM Studio).</td>
+          </tr>
+          <tr>
+            <td><code>baseUrl</code></td>
+            <td>string</td>
+            <td>No</td>
+            <td>Override the default base URL. Useful for proxies or self-hosted endpoints.</td>
+          </tr>
+          <tr>
+            <td><code>model</code></td>
+            <td>string</td>
+            <td>No</td>
+            <td>Model name to use. Defaults vary by provider (e.g., <code>claude-sonnet-4-5-20250929</code> for Anthropic).</td>
+          </tr>
+          <tr>
+            <td><code>streaming</code></td>
+            <td>boolean</td>
+            <td>No</td>
+            <td>Enable or disable streaming responses. Defaults to <code>true</code>.</td>
+          </tr>
+          <tr>
+            <td><code>contextWindow</code></td>
+            <td>number</td>
+            <td>No</td>
+            <td>Maximum context window size in tokens. Zubo uses this for context compaction decisions. Defaults to the provider's known maximum.</td>
+          </tr>
+        </tbody>
+      </table>
+      <h3>Multi-Provider Example with Failover</h3>
+<pre><code>{
+  "providers": {
+    "anthropic": {
+      "apiKey": "sk-ant-api03-...",
+      "model": "claude-sonnet-4-5-20250929",
+      "streaming": true,
+      "contextWindow": 200000
+    },
+    "openai": {
+      "apiKey": "sk-proj-...",
+      "model": "gpt-4o",
+      "streaming": true
+    },
+    "ollama": {
+      "baseUrl": "http://localhost:11434/v1",
+      "model": "llama3.3",
+      "streaming": true
+    }
+  },
+  "activeProvider": "anthropic",
+  "failover": ["openai", "ollama"]
+}</code></pre>
+      <p>In this configuration, Zubo uses Claude as the primary model. If Anthropic returns an error (rate limit, network issue, etc.), it automatically tries OpenAI next, and finally Ollama as a local fallback. The failover is transparent to the user &mdash; they receive a response regardless of which provider handled it.</p>
+      <h3>Smart Routing</h3>
+      <p>
+        Smart routing automatically selects the best provider for each query based on complexity. Simple questions (greetings, quick lookups, short follow-ups) are routed to fast, inexpensive models, while complex queries (multi-step reasoning, code generation, long-form writing) go to your most capable provider. This can significantly reduce costs without noticeable quality loss.
+      </p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>smartRouting.enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable automatic query routing between providers.</td>
+          </tr>
+          <tr>
+            <td><code>smartRouting.fastProvider</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>Provider key to use for simple queries (e.g., <code>"groq"</code>, <code>"deepseek"</code>).</td>
+          </tr>
+          <tr>
+            <td><code>smartRouting.complexProvider</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>Provider key to use for complex queries. Defaults to <code>activeProvider</code> if not set.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"smartRouting": {
+  "enabled": true,
+  "fastProvider": "groq",
+  "complexProvider": "anthropic"
+}</code></pre>
+      <p>When smart routing is enabled, Zubo classifies each incoming message and routes it accordingly. You can always override the routing for a specific message by prefixing it with the provider name (e.g., <code>@anthropic explain quantum computing</code>).</p>
+      <!-- ================================================================ -->
+      <h2 id="channel-configuration">Channel Configuration</h2>
+      <p>
+        Channels define how users interact with Zubo. Each channel is independently configured under the <code>channels</code> object. All enabled channels share the same memory, personality, tools, and conversation history &mdash; a fact learned via Telegram is immediately available in Discord or the web dashboard.
+      </p>
+      <h3>Web Chat</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>true</code></td>
+            <td>Enable the built-in web chat dashboard.</td>
+          </tr>
+          <tr>
+            <td><code>port</code></td>
+            <td>number</td>
+            <td><code>3000</code></td>
+            <td>HTTP port for the web dashboard and API.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"webchat": {
+  "enabled": true,
+  "port": 3000
+}</code></pre>
+      <h3>Telegram</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable the Telegram channel.</td>
+          </tr>
+          <tr>
+            <td><code>botToken</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>Bot token from <a href="https://t.me/BotFather" target="_blank" rel="noopener">@BotFather</a>.</td>
+          </tr>
+          <tr>
+            <td><code>allowedUsers</code></td>
+            <td>number[]</td>
+            <td><code>[]</code></td>
+            <td>Array of numeric Telegram user IDs allowed to interact. Empty array means no restriction.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"telegram": {
+  "enabled": true,
+  "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
+  "allowedUsers": [12345678, 87654321]
+}</code></pre>
+      <h3>Discord</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable the Discord channel.</td>
+          </tr>
+          <tr>
+            <td><code>botToken</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>Bot token from the <a href="https://discord.com/developers/applications" target="_blank" rel="noopener">Discord Developer Portal</a>.</td>
+          </tr>
+          <tr>
+            <td><code>allowedUsers</code></td>
+            <td>string[]</td>
+            <td><code>[]</code></td>
+            <td>Array of Discord user ID strings allowed to interact. Empty array means no restriction.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"discord": {
+  "enabled": true,
+  "botToken": "MTk4NjIyNDgzNDcxOTI1...",
+  "allowedUsers": ["198622483471925248"]
+}</code></pre>
+      <h3>Slack</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable the Slack channel.</td>
+          </tr>
+          <tr>
+            <td><code>botToken</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>Bot User OAuth Token (starts with <code>xoxb-</code>).</td>
+          </tr>
+          <tr>
+            <td><code>appToken</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>App-Level Token (starts with <code>xapp-</code>). Required for Socket Mode.</td>
+          </tr>
+          <tr>
+            <td><code>allowedUsers</code></td>
+            <td>string[]</td>
+            <td><code>[]</code></td>
+            <td>Array of Slack member ID strings allowed to interact. Empty array means no restriction.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"slack": {
+  "enabled": true,
+  "botToken": "xoxb-1234567890-abcdefghij",
+  "appToken": "xapp-1-A0123456789-1234567890123-abcdef",
+  "allowedUsers": ["U01ABCDEF"]
+}</code></pre>
+      <h3>WhatsApp</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable the WhatsApp channel.</td>
+          </tr>
+          <tr>
+            <td><code>authDir</code></td>
+            <td>string</td>
+            <td><code>~/.zubo/whatsapp-auth</code></td>
+            <td>Directory to store WhatsApp Web authentication data. On first run, a QR code is displayed for pairing.</td>
+          </tr>
+          <tr>
+            <td><code>allowedNumbers</code></td>
+            <td>string[]</td>
+            <td><code>[]</code></td>
+            <td>Array of phone numbers (with country code, e.g., <code>"14155551234"</code>) allowed to interact. Empty array means no restriction.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"whatsapp": {
+  "enabled": true,
+  "authDir": "/Users/you/.zubo/whatsapp-auth",
+  "allowedNumbers": ["14155551234", "447700900000"]
+}</code></pre>
+      <h3>Signal</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable the Signal channel.</td>
+          </tr>
+          <tr>
+            <td><code>phoneNumber</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>The phone number registered with Signal for the bot (with country code, e.g., <code>"+14155551234"</code>).</td>
+          </tr>
+          <tr>
+            <td><code>signalCliPath</code></td>
+            <td>string</td>
+            <td><code>signal-cli</code></td>
+            <td>Path to the <code>signal-cli</code> binary. Defaults to looking on the system PATH.</td>
+          </tr>
+          <tr>
+            <td><code>allowedNumbers</code></td>
+            <td>string[]</td>
+            <td><code>[]</code></td>
+            <td>Array of phone numbers allowed to interact. Empty array means no restriction.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"signal": {
+  "enabled": true,
+  "phoneNumber": "+14155551234",
+  "signalCliPath": "/usr/local/bin/signal-cli",
+  "allowedNumbers": ["+447700900000"]
+}</code></pre>
+      <!-- ================================================================ -->
+      <h2 id="voice-configuration">Voice Configuration</h2>
+      <p>
+        Zubo supports speech-to-text (STT) for transcribing voice messages received on any channel, and text-to-speech (TTS) for generating spoken audio responses. Voice is configured under the <code>voice</code> object.
+      </p>
+      <h3>Speech-to-Text (STT)</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>provider</code></td>
+            <td>string</td>
+            <td><code>"whisper"</code></td>
+            <td>STT provider. Currently supported: <code>whisper</code> (OpenAI Whisper API).</td>
+          </tr>
+          <tr>
+            <td><code>apiKey</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>API key for the STT provider. For Whisper, this is your OpenAI API key.</td>
+          </tr>
+          <tr>
+            <td><code>model</code></td>
+            <td>string</td>
+            <td><code>"whisper-1"</code></td>
+            <td>Model to use for transcription.</td>
+          </tr>
+        </tbody>
+      </table>
+      <h3>Text-to-Speech (TTS)</h3>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>provider</code></td>
+            <td>string</td>
+            <td><code>"openai"</code></td>
+            <td>TTS provider. Supported: <code>openai</code>, <code>elevenlabs</code>.</td>
+          </tr>
+          <tr>
+            <td><code>apiKey</code></td>
+            <td>string</td>
+            <td>&mdash;</td>
+            <td>API key for the TTS provider.</td>
+          </tr>
+          <tr>
+            <td><code>voice</code></td>
+            <td>string</td>
+            <td><code>"nova"</code></td>
+            <td>Voice to use for speech generation. OpenAI voices: <code>alloy</code>, <code>echo</code>, <code>fable</code>, <code>onyx</code>, <code>nova</code>, <code>shimmer</code>. ElevenLabs voices depend on your account.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"voice": {
+  "stt": {
+    "provider": "whisper",
+    "apiKey": "sk-proj-...",
+    "model": "whisper-1"
+  },
+  "tts": {
+    "provider": "openai",
+    "apiKey": "sk-proj-...",
+    "voice": "nova"
+  }
+}</code></pre>
+      <!-- ================================================================ -->
+      <h2 id="agent-settings">Agent Settings</h2>
+      <p>These top-level settings control the core agent behavior.</p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>maxTurns</code></td>
+            <td>number</td>
+            <td><code>50</code></td>
+            <td>Maximum number of tool-call rounds per conversation turn. When the agent reaches this limit, it stops calling tools and produces a text response with whatever information it has gathered. This prevents runaway tool loops. Reasonable values range from 10 (tightly constrained) to 100 (complex multi-step tasks).</td>
+          </tr>
+          <tr>
+            <td><code>heartbeatMinutes</code></td>
+            <td>number</td>
+            <td><code>30</code></td>
+            <td>Interval in minutes (1&ndash;1440) between heartbeat cycles. During each heartbeat, Zubo wakes up, checks for pending cron jobs, processes scheduled tasks, evaluates proactive memory triggers, and optionally sends notifications. Set to a low value (1&ndash;5) for near-real-time scheduling, or a high value (60&ndash;1440) to conserve resources.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>{
+  "maxTurns": 50,
+  "heartbeatMinutes": 30
+}</code></pre>
+      <!-- ================================================================ -->
+      <h2 id="rate-limiting">Rate Limiting</h2>
+      <p>
+        Zubo includes built-in per-IP rate limiting to protect against abuse. Rate limits use a sliding window algorithm &mdash; each IP address gets an independent counter that resets on a rolling 60-second basis.
+      </p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>rateLimit.chatPerMinute</code></td>
+            <td>number</td>
+            <td><code>60</code></td>
+            <td>Maximum chat messages per minute per IP address. Applies to the <code>/api/chat</code> endpoint and WebSocket messages. When exceeded, the client receives a <code>429 Too Many Requests</code> response.</td>
+          </tr>
+          <tr>
+            <td><code>rateLimit.uploadPerMinute</code></td>
+            <td>number</td>
+            <td><code>10</code></td>
+            <td>Maximum file uploads per minute per IP address. Applies to the <code>/api/upload</code> endpoint. Uploads are more resource-intensive (document parsing, chunking, embedding), so the default is lower.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"rateLimit": {
+  "chatPerMinute": 60,
+  "uploadPerMinute": 10
+}</code></pre>
+      <p>For personal use on localhost, the defaults are generous. If you are exposing Zubo on a public network or sharing it with others, consider lowering these values (e.g., <code>chatPerMinute: 30</code>, <code>uploadPerMinute: 5</code>).</p>
+      <!-- ================================================================ -->
+      <h2 id="budget-controls">Budget Controls</h2>
+      <p>
+        Zubo tracks token usage and estimated costs for every LLM request. You can set spending limits to prevent surprise bills and view per-model cost breakdowns in the dashboard.
+      </p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>budget.dailyLimit</code></td>
+            <td>number</td>
+            <td><code>0</code></td>
+            <td>Maximum daily spend in USD. Set to <code>0</code> for no limit. When the limit is reached, Zubo pauses LLM requests and notifies you.</td>
+          </tr>
+          <tr>
+            <td><code>budget.monthlyLimit</code></td>
+            <td>number</td>
+            <td><code>0</code></td>
+            <td>Maximum monthly spend in USD. Set to <code>0</code> for no limit.</td>
+          </tr>
+          <tr>
+            <td><code>budget.warningThreshold</code></td>
+            <td>number</td>
+            <td><code>0.8</code></td>
+            <td>Percentage (0&ndash;1) of the budget at which Zubo sends a warning notification. Default is 80%.</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"budget": {
+  "dailyLimit": 5,
+  "monthlyLimit": 50,
+  "warningThreshold": 0.8
+}</code></pre>
+      <p>Cost tracking is always active even without spending limits. View your usage breakdown in the dashboard under Analytics &rarr; Costs, or ask Zubo directly: &ldquo;How much have I spent today?&rdquo;</p>
+      <!-- ================================================================ -->
+      <h2 id="authentication">Authentication</h2>
+      <p>
+        When <code>auth.enabled</code> is <code>true</code>, all HTTP API endpoints and WebSocket connections require a valid API key. This is strongly recommended if you are exposing Zubo's port beyond localhost.
+      </p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>auth.enabled</code></td>
+            <td>boolean</td>
+            <td><code>false</code></td>
+            <td>Enable API key authentication for all HTTP and WebSocket endpoints.</td>
+          </tr>
+        </tbody>
+      </table>
+      <h3>Managing API Keys</h3>
+      <p>API keys can be created and managed via the CLI or the web dashboard:</p>
+<pre><code># Create a new API key
+zubo auth create --name "my-app"
+# Output: API key created: zb_k1_a1b2c3d4e5f6...
+# List all API keys
+zubo auth list
+# Revoke an API key
+zubo auth revoke zb_k1_a1b2c3d4e5f6...</code></pre>
+      <h3>Using API Keys</h3>
+      <p>Include the API key in the <code>Authorization</code> header as a Bearer token:</p>
+<pre><code>curl -X POST http://localhost:3000/api/chat \
+  -H "Authorization: Bearer zb_k1_a1b2c3d4e5f6..." \
+  -H "Content-Type: application/json" \
+  -d '{"message": "Hello, Zubo!"}'</code></pre>
+      <p>For WebSocket connections, pass the key as a query parameter:</p>
+<pre><code>ws://localhost:3000/ws?token=zb_k1_a1b2c3d4e5f6...</code></pre>
+      <p>API keys are stored as hashed values in the SQLite database. The plain-text key is only shown once at creation time and cannot be retrieved later. If you lose a key, revoke it and create a new one.</p>
+      <!-- ================================================================ -->
+      <h2 id="sandbox">Sandbox</h2>
+      <p>
+        The sandbox controls how user-installed skills (from <code>~/.zubo/workspace/skills/</code>) are executed. Built-in tools always run in the main process, but user skills run in isolated subprocesses for safety.
+      </p>
+      <table>
+        <thead>
+          <tr>
+            <th>Field</th>
+            <th>Type</th>
+            <th>Default</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>sandbox.enabled</code></td>
+            <td>boolean</td>
+            <td><code>true</code></td>
+            <td>Enable subprocess sandboxing for user-installed skills. When enabled, each skill invocation runs in a separate Bun subprocess with restricted access. Disabling this is not recommended but may be necessary for skills that require direct main-process access.</td>
+          </tr>
+          <tr>
+            <td><code>sandbox.timeoutMs</code></td>
+            <td>number</td>
+            <td><code>30000</code></td>
+            <td>Maximum execution time in milliseconds for a single skill invocation. If a skill exceeds this timeout, its subprocess is terminated and an error is returned to the agent. Set higher for skills that perform long-running operations (e.g., large file processing, slow API calls).</td>
+          </tr>
+        </tbody>
+      </table>
+<pre><code>"sandbox": {
+  "enabled": true,
+  "timeoutMs": 30000
+}</code></pre>
+      <!-- ================================================================ -->
+      <h2 id="full-example">Full Example</h2>
+      <p>Here is a complete <code>~/.zubo/config.json</code> showing all configuration sections together. This represents a fully configured instance with Anthropic as the primary provider, Groq for smart routing, Ollama as a local failover, three channels enabled, voice support, budget controls, and production-ready security settings:</p>
+<pre><code>{
+  "providers": {
+    "anthropic": {
+      "apiKey": "sk-ant-api03-...",
+      "model": "claude-sonnet-4-5-20250929",
+      "streaming": true,
+      "contextWindow": 200000
+    },
+    "groq": {
+      "apiKey": "gsk_...",
+      "model": "llama-3.3-70b-versatile",
+      "streaming": true
+    },
+    "ollama": {
+      "baseUrl": "http://localhost:11434/v1",
+      "model": "llama3.3",
+      "streaming": true
+    }
+  },
+  "activeProvider": "anthropic",
+  "failover": ["groq", "ollama"],
+  "smartRouting": {
+    "enabled": true,
+    "fastProvider": "groq",
+    "complexProvider": "anthropic"
+  },
+  "channels": {
+    "webchat": {
+      "enabled": true,
+      "port": 3000
+    },
+    "telegram": {
+      "enabled": true,
+      "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
+      "allowedUsers": [12345678]
+    },
+    "discord": {
+      "enabled": true,
+      "botToken": "MTk4NjIyNDgzNDcxOTI1...",
+      "allowedUsers": []
+    },
+    "slack": {
+      "enabled": false,
+      "botToken": "",
+      "appToken": "",
+      "allowedUsers": []
+    },
+    "whatsapp": {
+      "enabled": false,
+      "authDir": "",
+      "allowedNumbers": []
+    },
+    "signal": {
+      "enabled": false,
+      "phoneNumber": "",
+      "signalCliPath": "signal-cli",
+      "allowedNumbers": []
+    }
+  },
+  "voice": {
+    "stt": {
+      "provider": "whisper",
+      "apiKey": "sk-proj-...",
+      "model": "whisper-1"
+    },
+    "tts": {
+      "provider": "openai",
+      "apiKey": "sk-proj-...",
+      "voice": "nova"
+    }
+  },
+  "maxTurns": 50,
+  "heartbeatMinutes": 30,
+  "rateLimit": {
+    "chatPerMinute": 60,
+    "uploadPerMinute": 10
+  },
+  "budget": {
+    "dailyLimit": 5,
+    "monthlyLimit": 50,
+    "warningThreshold": 0.8
+  },
+  "auth": {
+    "enabled": false
+  },
+  "sandbox": {
+    "enabled": true,
+    "timeoutMs": 30000
+  }
+}</code></pre>
+      <p><strong>Tip:</strong> You do not need to include every field. Zubo applies sensible defaults for any omitted values. A minimal config only needs <code>activeProvider</code> and the corresponding provider entry with an API key.</p>
+      <!-- ================================================================ -->
+      <h2 id="environment">Environment</h2>
+      <p>
+        By default, Zubo stores all data and configuration under <code>~/.zubo</code>. You can override this by setting the <code>ZUBO_HOME</code> environment variable to an absolute path:
+      </p>
+<pre><code># Use a custom home directory
+export ZUBO_HOME=/opt/zubo-data
+zubo start
+# Or inline for a single invocation
+ZUBO_HOME=/opt/zubo-data zubo start --daemon</code></pre>
+      <p>When <code>ZUBO_HOME</code> is set, all paths &mdash; config file, database, logs, sessions, models, and workspace &mdash; are resolved relative to that directory instead of <code>~/.zubo</code>. This is useful for running multiple isolated Zubo instances on the same machine, or for placing the data directory on a specific volume or mount point.</p>
+      <p>Other environment variables recognized by Zubo:</p>
+      <table>
+        <thead>
+          <tr>
+            <th>Variable</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><code>ZUBO_HOME</code></td>
+            <td>Override the default <code>~/.zubo</code> data directory.</td>
+          </tr>
+          <tr>
+            <td><code>ZUBO_LOG_LEVEL</code></td>
+            <td>Set the log level: <code>debug</code>, <code>info</code>, <code>warn</code>, <code>error</code>. Defaults to <code>info</code>.</td>
+          </tr>
+          <tr>
+            <td><code>ZUBO_PORT</code></td>
+            <td>Override the web dashboard port (takes precedence over config file).</td>
+          </tr>
+          <tr>
+            <td><code>NODE_ENV</code></td>
+            <td>When set to <code>production</code>, Zubo disables verbose logging and enables additional security hardening.</td>
+          </tr>
+        </tbody>
+      </table>
+      <div class="docs-page-nav">
+        <a href="index.html"><span class="nav-dir">Previous</span><span class="nav-label">&larr; Overview</span></a>
+        <a href="agents.html"><span class="nav-dir">Next</span><span class="nav-label">Agents &amp; Workflows &rarr;</span></a>
+      </div>
+    </main>
+  </div>
+  <button class="docs-sidebar-toggle" id="docs-sidebar-toggle" aria-label="Toggle sidebar">&#9776;</button>
+  <script src="../script.js"></script>
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    "itemListElement": [
+      { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://zubo.bot/" },
+      { "@type": "ListItem", "position": 2, "name": "Docs", "item": "https://zubo.bot/docs/" },
+      { "@type": "ListItem", "position": 3, "name": "Configuration", "item": "https://zubo.bot/docs/config.html" }
+    ]
+  }
+  </script>
+</body>
+</html>