zubo 0.1.20 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zubo",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Your AI agent that never forgets. Persistent memory, 25+ tools, 7 channels, 11+ LLM providers — runs entirely on your machine.",
   "license": "MIT",
   "author": "thomaskanze",

package/site/docs/agents.html

@@ -89,11 +89,11 @@
       <p>By default, Zubo operates as a single agent that handles all messages across every connected channel using a unified session identified as "owner." This default agent has access to all registered tools &mdash; both built-in tools and any user-installed skills &mdash; and its personality and behavior are defined by the system prompt stored at <code>~/.zubo/workspace/SYSTEM.md</code>.</p>
       <p>For many use cases, the default agent is all you need. It can search the web, manage your calendar, write code, read and write memory, and use any skill you install. Custom agents become valuable when you want to restrict tool access, provide specialized instructions, or build multi-step workflows.</p>
 
-      <h2>Custom System Prompt</h2>
+      <h2>Personality</h2>
       <p>The system prompt defines your agent's personality, rules, and background knowledge. There are two ways to customize it:</p>
       <ul>
         <li><strong>Edit the file directly</strong> &mdash; Open <code>~/.zubo/workspace/SYSTEM.md</code> in any text editor and modify it.</li>
-        <li><strong>Use the dashboard</strong> &mdash; Navigate to the System Prompt panel in the web dashboard and edit it there. Changes are saved to <code>SYSTEM.md</code> automatically.</li>
+        <li><strong>Use the dashboard</strong> &mdash; Navigate to the Personality panel in the web dashboard and edit it there. Changes are saved to <code>SYSTEM.md</code> automatically.</li>
       </ul>
       <p>Here is an example <code>SYSTEM.md</code> that defines a personalized assistant:</p>
 <pre><code># System Prompt

package/site/docs/api.html

@@ -200,7 +200,7 @@ file: &lt;document&gt;</code></pre>
   "Status": "running"
 }</code></pre>
 
-      <h3>System Prompt</h3>
+      <h3>Personality</h3>
 <pre><code>GET /api/dashboard/system</code></pre>
       <p>Retrieve the current system prompt.</p>
 <pre><code>PUT /api/dashboard/system
@@ -583,7 +583,7 @@ Content-Type: application/json
 <pre><code>GET /api/dashboard/channel-status</code></pre>
       <p>Returns the configuration and connection status for each channel (webchat, Telegram, Discord, Slack, WhatsApp, Signal). Each channel reports whether it is configured and whether it is currently enabled.</p>
 
-      <h3>Secrets Management</h3>
+      <h3>API Keys Management</h3>
 <pre><code>GET /api/dashboard/secrets</code></pre>
       <p>List all stored secrets. Values are masked in the response for security.</p>
 <pre><code>GET /api/dashboard/secrets/:name</code></pre>

package/site/docs/index.html

@@ -69,7 +69,7 @@
           <a href="/docs/conversations">Conversation History</a>
           <a href="/docs/webhooks">Webhooks</a>
           <a href="/docs/workflows">Visual Workflows</a>
-          <a href="/docs/marketplace">MCP Marketplace</a>
+          <a href="/docs/marketplace">Extensions Marketplace</a>
         </div>
       </div>
       <div class="docs-sidebar-section">
@@ -300,10 +300,10 @@ docker compose up -d</code></pre>
 
       <p>The wizard walks you through 4 steps:</p>
       <ul>
-        <li><strong>Step 1: LLM Provider</strong> &mdash; choose from 15 supported providers (Anthropic, OpenAI, Ollama, Groq, Together, OpenRouter, DeepSeek, xAI, MiniMax, Fireworks, Cerebras, LM Studio, Claude Code, Codex, or any OpenAI-compatible endpoint) and enter your API key. Optionally configure a fallback provider for automatic failover.</li>
+        <li><strong>Step 1: AI Provider</strong> &mdash; choose from 15 supported providers (Anthropic, OpenAI, Ollama, Groq, Together, OpenRouter, DeepSeek, xAI, MiniMax, Fireworks, Cerebras, LM Studio, Claude Code, Codex, or any OpenAI-compatible endpoint) and enter your API key. Optionally configure a fallback provider for automatic failover.</li>
         <li><strong>Step 2: Channels</strong> &mdash; enable any combination of Telegram, Discord, Slack, WhatsApp, Signal, and Email. Enter the required tokens and credentials for each. Web Chat is always on and requires no configuration.</li>
         <li><strong>Step 3: Personalization</strong> &mdash; set your agent's name and describe its personality. This shapes how Zubo talks to you across all channels.</li>
-        <li><strong>Step 4: Smart Routing</strong> &mdash; optionally configure a fast model (e.g., Groq) for simple queries. Smart routing automatically detects low-complexity messages and routes them to the cheaper, faster model, saving 50&ndash;80% on costs without sacrificing quality for complex tasks.</li>
+        <li><strong>Step 4: Smart Cost Savings</strong> &mdash; optionally configure a fast model (e.g., Groq) for simple queries. Smart routing automatically detects low-complexity messages and routes them to the cheaper, faster model, saving 50&ndash;80% on costs without sacrificing quality for complex tasks.</li>
       </ul>
       <p>The wizard also creates the <code>~/.zubo</code> directory and all required subdirectories, generates your <code>~/.zubo/config.json</code> file, and downloads the all-MiniLM-L6-v2 embedding model (~80 MB) for local semantic memory.</p>
 
@@ -624,7 +624,7 @@ zubo start --daemon</code></pre>
         <li><strong>Use <code>zubo start --daemon</code></strong> for always-on operation. Zubo writes a PID file and rotates logs automatically.</li>
         <li><strong>Check <code>zubo status</code> and <code>zubo logs</code></strong> for troubleshooting. The status command shows uptime, memory usage, connected channels, and pending scheduled jobs.</li>
         <li><strong>Back up your data</strong> with <code>zubo export</code> for a full JSON export, or rely on the automatic daily SQLite backups in <code>~/.zubo/workspace/backups/</code>.</li>
-        <li><strong>Enable smart routing</strong> to automatically send simple queries to fast, cheap models. Set <code>smartRouting.enabled</code> to <code>true</code> and configure a <code>fastProvider</code> (e.g., Groq) alongside your primary. This can cut costs significantly.</li>
+        <li><strong>Enable smart cost savings</strong> to automatically send simple queries to fast, cheap models. Set <code>smartRouting.enabled</code> to <code>true</code> and configure a <code>fastProvider</code> (e.g., Groq) alongside your primary. This can cut costs significantly.</li>
         <li><strong>Set a budget</strong> to avoid surprise bills: <code>zubo config set budget.dailyLimit 5</code>. Cost tracking is always active in the dashboard under Analytics &rarr; Costs.</li>
         <li><strong>Configure failover providers</strong> so your agent stays available even if your primary LLM provider has an outage. For example, set Anthropic as primary and Ollama as failover for fully offline operation when the cloud is down.</li>
         <li><strong>Keep skills small and focused</strong> &mdash; one skill per task. This makes them easier to test, share, and debug.</li>
@@ -644,7 +644,7 @@ zubo start --daemon</code></pre>
         <li><a href="/docs/conversations"><strong>Conversation History</strong></a> &mdash; unified cross-channel history with FTS5 search, dashboard browsing, and API access for searching and analyzing past conversations across all channels.</li>
         <li><a href="/docs/webhooks"><strong>Webhooks</strong></a> &mdash; create webhook endpoints for GitHub, Stripe, CI/CD, and any external service. HMAC signature verification, prompt templates with <code>{{payload}}</code> substitution, and dashboard management.</li>
         <li><a href="/docs/workflows"><strong>Visual Workflows</strong></a> &mdash; build multi-step automations with the drag-and-drop workflow builder. Step types (tool, agent, condition, message, delay), triggers (manual, cron, webhook), and template variables.</li>
-        <li><a href="/docs/marketplace"><strong>MCP Marketplace</strong></a> &mdash; browse, install, and manage MCP servers from the official registry. One-click installation with automatic tool registration.</li>
+        <li><a href="/docs/marketplace"><strong>Extensions Marketplace</strong></a> &mdash; browse, install, and manage MCP servers from the official registry. One-click installation with automatic tool registration.</li>
         <li><a href="/docs/integrations"><strong>Integrations</strong></a> &mdash; connect Zubo to GitHub, Google Workspace, Notion, Linear, Jira, and more. <a href="/docs/integrations#oauth">OAuth 2.0 authentication</a> with automatic token refresh, API key setup, and usage examples.</li>
         <li><a href="/docs/security"><strong>Security &amp; Auth</strong></a> &mdash; harden your Zubo instance: API key management, tool permission levels, confirmation tokens, rate limiting, file access restrictions, and network security.</li>
         <li><a href="/docs/api"><strong>API Reference</strong></a> &mdash; complete HTTP API documentation for programmatic access: endpoints, request/response formats, authentication, and WebSocket streaming.</li>

package/site/docs/integrations.html

@@ -101,7 +101,7 @@
       <p>There are three ways to connect a service:</p>
       <ol>
         <li><strong>Chat:</strong> Tell Zubo directly &mdash; for example, <code>"Connect GitHub with token ghp_abc123"</code>. Zubo will store the secret and install the skill pack automatically.</li>
-        <li><strong>Dashboard:</strong> Navigate to Settings &rarr; Secrets &rarr; Add Secret. Enter the secret name and value, then Zubo detects the associated integration and installs the skills.</li>
+        <li><strong>Dashboard:</strong> Navigate to Settings &rarr; API Keys. Enter the secret name and value, then Zubo detects the associated integration and installs the skills.</li>
         <li><strong>CLI:</strong> Run <code>zubo start</code>, then use the <code>connect_service</code> tool programmatically to provide the credentials.</li>
       </ol>
       <p>When you connect a service, Zubo performs the following steps:</p>
@@ -384,11 +384,11 @@ zubo mcp-serve</code></pre>
         </tbody>
       </table>
 
-      <h2 id="managing-secrets">Managing Secrets</h2>
+      <h2 id="managing-secrets">Managing API Keys</h2>
       <p>All integration secrets are managed through the same unified secret system.</p>
       <h3>Dashboard</h3>
       <ul>
-        <li>Navigate to Settings &rarr; Secrets &amp; API Keys</li>
+        <li>Navigate to Settings &rarr; API Keys</li>
         <li>Values are displayed as <code>&bull;&bull;&bull;&bull;&bull;&bull;&bull;&bull;</code> by default</li>
         <li>Click <strong>&ldquo;Reveal&rdquo;</strong> to show the actual secret value</li>
         <li>Click <strong>&ldquo;Edit&rdquo;</strong> to update a secret with a new value</li>

package/site/docs/marketplace.html

@@ -3,18 +3,18 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>MCP Marketplace — Zubo Docs</title>
+  <title>Extensions Marketplace — Zubo Docs</title>
   <meta name="description" content="Browse, install, and manage MCP servers from the built-in marketplace. Extend Zubo with community-built tools, one-click installs, and automatic configuration.">
   <meta name="theme-color" content="#060608">
   <link rel="canonical" href="https://zubo.bot/docs/marketplace">
-  <meta property="og:title" content="MCP Marketplace — Zubo Docs">
+  <meta property="og:title" content="Extensions Marketplace — Zubo Docs">
   <meta property="og:description" content="Browse, install, and manage MCP servers from the built-in marketplace. Extend Zubo with community-built tools, one-click installs, and automatic configuration.">
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://zubo.bot/docs/marketplace">
   <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="MCP Marketplace — Zubo Docs">
+  <meta name="twitter:title" content="Extensions Marketplace — Zubo Docs">
   <meta name="twitter:description" content="Browse, install, and manage MCP servers from the built-in marketplace. Extend Zubo with community-built tools, one-click installs, and automatic configuration.">
   <meta name="twitter:image" content="https://zubo.bot/og-image.png">
   <meta name="twitter:creator" content="@thomaskanze">
@@ -67,7 +67,7 @@
           <a href="/docs/conversations">Conversation History</a>
           <a href="/docs/webhooks">Webhooks</a>
           <a href="/docs/workflows">Visual Workflows</a>
-          <a href="/docs/marketplace" class="active">MCP Marketplace</a>
+          <a href="/docs/marketplace" class="active">Extensions Marketplace</a>
         </div>
       </div>
       <div class="docs-sidebar-section">
@@ -89,12 +89,12 @@
     </aside>
 
     <main class="docs-content">
-      <div class="docs-breadcrumb"><a href="/">Home</a><span>/</span><a href="/docs/">Docs</a><span>/</span>MCP Marketplace</div>
+      <div class="docs-breadcrumb"><a href="/">Home</a><span>/</span><a href="/docs/">Docs</a><span>/</span>Extensions Marketplace</div>
 
-      <h1>MCP Marketplace</h1>
+      <h1>Extensions Marketplace</h1>
 
       <p>
-        The MCP Marketplace lets you browse, install, and manage MCP (Model Context Protocol) servers from the official registry directly through the Zubo dashboard or API. Instead of manually configuring MCP server commands and arguments, you can discover servers from the community, install them with one click, and have their tools automatically registered in Zubo.
+        The Extensions Marketplace lets you browse, install, and manage MCP (Model Context Protocol) servers from the official registry directly through the Zubo dashboard or API. Instead of manually configuring MCP server commands and arguments, you can discover servers from the community, install them with one click, and have their tools automatically registered in Zubo.
       </p>
 
       <!-- ================================================================ -->
@@ -107,7 +107,7 @@
       <h3>Via the Dashboard</h3>
 
       <ol>
-        <li>Open the web dashboard and navigate to the <strong>MCP</strong> panel in the sidebar.</li>
+        <li>Open the web dashboard and navigate to the <strong>Extensions</strong> panel in the sidebar.</li>
         <li>Click the <strong>Marketplace</strong> tab to view the available servers from the registry.</li>
         <li>Use the search bar to filter servers by name or keyword (e.g., "filesystem", "database", "github").</li>
         <li>Each server card shows the name, description, author, tool count, and install status.</li>
@@ -291,7 +291,7 @@ Content-Type: application/json
     "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": "MCP Marketplace", "item": "https://zubo.bot/docs/marketplace" }
+      { "@type": "ListItem", "position": 3, "name": "Extensions Marketplace", "item": "https://zubo.bot/docs/marketplace" }
     ]
   }
   </script>

package/site/docs/security.html

@@ -169,18 +169,18 @@
 
       <h2 id="secret-management">Secret Management</h2>
       <p>Secrets (API keys, tokens, passwords) are stored securely in the local SQLite <code>secrets</code> table. The agent can use secrets by name but <strong>never sees their actual values</strong> in conversation context.</p>
-      <h3>Storing Secrets</h3>
+      <h3>Storing API Keys</h3>
       <p>There are three ways to store a secret:</p>
       <ul>
         <li><strong>Chat:</strong> Tell Zubo directly &mdash; <code>"Store my GitHub token: ghp_abc123xyz"</code></li>
         <li><strong>Tool:</strong> The <code>secret_set</code> tool can be called programmatically</li>
-        <li><strong>Dashboard:</strong> Navigate to Settings &rarr; Secrets and use the form</li>
+        <li><strong>Dashboard:</strong> Navigate to Settings &rarr; API Keys and use the form</li>
       </ul>
-      <h3>Accessing Secrets in Skills</h3>
+      <h3>Accessing API Keys in Skills</h3>
       <p>User-installed skills can access secrets via environment variables:</p>
 <pre><code>const token = process.env.ZUBO_SECRET_GITHUB_TOKEN;</code></pre>
       <p>Only secrets explicitly declared in the skill manifest are passed to the skill process.</p>
-      <h3>Managing Secrets</h3>
+      <h3>Managing API Keys</h3>
       <ul>
         <li><strong>Dashboard:</strong> View masked values (<code>&bull;&bull;&bull;&bull;&bull;&bull;&bull;&bull;</code>), click &ldquo;Reveal&rdquo; to show the actual value, click &ldquo;Edit&rdquo; to update, or &ldquo;Delete&rdquo; to remove</li>
         <li><strong>Naming:</strong> Secret names must match the pattern <code>[a-z0-9_]+</code> (lowercase alphanumeric and underscores only)</li>

package/site/docs/skills.html

@@ -162,7 +162,7 @@ export default async function (input: Record<string, unknown>): Promise&lt
         <li><strong>Cannot import from Zubo internals</strong> &mdash; skills run in a sandboxed subprocess and have no access to Zubo's core modules, database, or session state</li>
       </ul>
 
-      <h2>Accessing Secrets</h2>
+      <h2>Accessing API Keys</h2>
       <p>Skills often need API keys or credentials to call external services. Zubo provides a secure way to pass secrets to skill handlers via environment variables:</p>
 <pre><code>export default async function (input: Record&lt;string, unknown&gt;): Promise&lt;string&gt; {
   const apiKey = process.env.ZUBO_SECRET_WEATHER_API_KEY;

package/site/index.html

@@ -4,18 +4,18 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Zubo — Your AI Agent. Your Machine. Your Rules.</title>
-  <meta name="description" content="Open-source AI agent that runs on your machine. One command to install, one file to configure. Persistent memory, 25+ tools, 7 messaging channels, 12+ LLM providers. MCP compatible. Zero complexity.">
+  <meta name="description" content="Open-source AI agent that runs on your machine. One command to install, one file to configure. Persistent memory, 25+ tools, 7 messaging channels, 12+ AI providers. Extension compatible. Zero complexity.">
   <meta name="theme-color" content="#060608">
   <link rel="canonical" href="https://zubo.bot/">
   <meta property="og:title" content="Zubo — Your AI Agent. Your Machine. Your Rules.">
-  <meta property="og:description" content="Open-source AI agent that runs on your machine. Persistent memory, 25+ tools, works across Telegram, Discord, Slack, WhatsApp, Email, and more. MCP compatible. One install, zero cloud.">
+  <meta property="og:description" content="Open-source AI agent that runs on your machine. Persistent memory, 25+ tools, works across Telegram, Discord, Slack, WhatsApp, Email, and more. Extension compatible. One install, zero cloud.">
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://zubo.bot/">
   <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="Zubo — Your AI Agent. Your Machine. Your Rules.">
-  <meta name="twitter:description" content="Open-source AI agent that runs on your machine. Persistent memory, 25+ tools, works across Telegram, Discord, Slack, WhatsApp, Email, and more. MCP compatible. One install, zero cloud.">
+  <meta name="twitter:description" content="Open-source AI agent that runs on your machine. Persistent memory, 25+ tools, works across Telegram, Discord, Slack, WhatsApp, Email, and more. Extension compatible. One install, zero cloud.">
   <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">
@@ -264,7 +264,7 @@
             <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg>
           </div>
           <h3>25+ Smart Tools</h3>
-          <p>Web search, file operations, code interpreter, image generation, APIs, webhooks, and more. Knowledge graph memory, MCP support, and sub-agent delegation for complex tasks.</p>
+          <p>Web search, file operations, code interpreter, image generation, APIs, webhooks, and more. Knowledge graph memory, extension support, and sub-agent delegation for complex tasks.</p>
         </div>
 
         <div class="bento-card tilt-card" data-feature="privacy">

package/site/install.sh

@@ -29,7 +29,9 @@ ARCH="$(uname -m)"
 case "$OS" in
   Linux*)  PLATFORM="linux" ;;
   Darwin*) PLATFORM="darwin" ;;
-  *)       fail "Unsupported OS: $OS. Zubo supports macOS and Linux." ;;
+  MINGW*|MSYS*|CYGWIN*)
+           fail "Windows detected. Use WSL (Windows Subsystem for Linux) to run Zubo:\n\n  ${DIM}wsl --install${RESET}\n  Then run this installer inside WSL." ;;
+  *)       fail "Unsupported OS: $OS. Zubo supports macOS, Linux, and Windows (via WSL)." ;;
 esac
 
 case "$ARCH" in
@@ -45,7 +47,7 @@ if command -v bun &>/dev/null; then
   BUN_VERSION=$(bun --version 2>/dev/null || echo "unknown")
   ok "Bun already installed (v${BUN_VERSION})"
 else
-  info "Installing Bun runtime..."
+  info "Installing Bun (a fast JavaScript runtime Zubo needs)..."
   curl -fsSL https://bun.sh/install | bash
 
   # Source the updated profile so bun is on PATH
@@ -55,7 +57,7 @@ else
   if command -v bun &>/dev/null; then
     ok "Bun installed (v$(bun --version))"
   else
-    fail "Bun installation failed. Install manually: https://bun.sh"
+    fail "Bun installation failed. Visit https://bun.sh for manual install instructions."
   fi
 fi
 
@@ -78,9 +80,13 @@ else
   # Bun global bin might not be on PATH yet
   ZUBO_BIN="${HOME}/.bun/bin/zubo"
   if [ -f "$ZUBO_BIN" ]; then
-    warn "Zubo installed but not on PATH. Add this to your shell profile:"
+    warn "Zubo installed but your terminal can't find it yet."
     echo ""
-    echo -e "  ${DIM}export PATH=\"\$HOME/.bun/bin:\$PATH\"${RESET}"
+    echo -e "  Run this command, then restart your terminal:"
+    echo ""
+    echo -e "  ${BOLD}echo 'export PATH=\"\$HOME/.bun/bin:\$PATH\"' >> ~/.bashrc && source ~/.bashrc${RESET}"
+    echo ""
+    echo -e "  ${DIM}(On macOS with zsh, use ~/.zshrc instead of ~/.bashrc)${RESET}"
     echo ""
   else
     fail "Zubo binary not found after install"

package/src/channels/dashboard.html.ts

@@ -928,7 +928,7 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
       <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7" rx="1"/><rect x="14" y="3" width="7" height="7" rx="1"/><rect x="3" y="14" width="7" height="7" rx="1"/><rect x="14" y="14" width="7" height="7" rx="1"/></svg></span> Dashboard
     </a>
     <a href="#memory" onclick="showPanel('memory')">
-      <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2C8.5 2 6 4.5 6 7c0 1.5.5 2.8 1.4 3.8C6.5 12 6 13.5 6 15c0 3.5 2.5 7 6 7s6-3.5 6-7c0-1.5-.5-3-1.4-4.2C17.5 9.8 18 8.5 18 7c0-2.5-2.5-5-6-5z"/><path d="M9 10h6"/><path d="M9 14h6"/></svg></span> Memory
+      <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2C8.5 2 6 4.5 6 7c0 1.5.5 2.8 1.4 3.8C6.5 12 6 13.5 6 15c0 3.5 2.5 7 6 7s6-3.5 6-7c0-1.5-.5-3-1.4-4.2C17.5 9.8 18 8.5 18 7c0-2.5-2.5-5-6-5z"/><path d="M9 10h6"/><path d="M9 14h6"/></svg></span> Knowledge
     </a>
     <a href="#skills" onclick="showPanel('skills')">
       <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg></span> Skills
@@ -940,7 +940,7 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
       <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M18 16.98h1.67c2.49 0 4.5-2.01 4.5-4.49 0-2.48-2.01-4.49-4.5-4.49h-.16C19.17 5.35 16.68 3 13.67 3 11.23 3 9.14 4.56 8.34 6.78c-.3-.05-.6-.08-.91-.08-2.76 0-5 2.24-5 5s2.24 5 5 5h1.48"/><polyline points="12 13 12 21"/><polyline points="9 18 12 21 15 18"/></svg></span> Webhooks
     </a>
     <a href="#mcp" onclick="showPanel('mcp')">
-      <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="6" width="20" height="12" rx="2"/><path d="M6 12h4"/><path d="M14 12h4"/><circle cx="8" cy="12" r="1"/><circle cx="16" cy="12" r="1"/></svg></span> MCP
+      <span class="nav-svg-icon"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="6" width="20" height="12" rx="2"/><path d="M6 12h4"/><path d="M14 12h4"/><circle cx="8" cy="12" r="1"/><circle cx="16" cy="12" r="1"/></svg></span> Extensions
     </a>
     <div class="sidebar-divider"></div>
     <div class="sidebar-section">Settings</div>
@@ -989,11 +989,11 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
               <div class="suggestion-chips-group">
                 <div class="chip-row">
                   <button class="suggestion-chip" onclick="useSuggestion(this)">What can you do?</button>
-                  <button class="suggestion-chip" onclick="useSuggestion(this)">Check my schedule</button>
+                  <button class="suggestion-chip" onclick="useSuggestion(this)">Set a reminder for tomorrow</button>
                 </div>
                 <div class="chip-row">
-                  <button class="suggestion-chip" onclick="useSuggestion(this)">Summarize recent emails</button>
-                  <button class="suggestion-chip" onclick="useSuggestion(this)">Set a reminder</button>
+                  <button class="suggestion-chip" onclick="useSuggestion(this)">Help me write an email</button>
+                  <button class="suggestion-chip" onclick="useSuggestion(this)">Explain something to me</button>
                 </div>
               </div>
             </div>
@@ -1099,6 +1099,9 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
     <!-- MEMORY PANEL -->
     <div id="panel-memory" class="panel">
       <div class="panel-body">
+        <div style="margin-bottom:20px;">
+          <p class="settings-desc" style="margin-bottom:0;">Everything Zubo remembers about you and your conversations. Edit the persistent memory file directly, or search through individual memory chunks below.</p>
+        </div>
         <div class="editor-wrap">
           <div class="editor-toolbar">
             <button class="btn btn-primary" onclick="saveMemory()">Save MEMORY.md</button>
@@ -1122,6 +1125,9 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
     <!-- SKILLS PANEL (with Browse/Registry tab) -->
     <div id="panel-skills" class="panel">
       <div class="panel-body">
+        <div style="margin-bottom:16px;">
+          <p class="settings-desc" style="margin-bottom:0;">Skills are custom capabilities you can add to Zubo. Browse the community registry to install new ones, or build your own in TypeScript.</p>
+        </div>
         <div class="tab-bar" id="skills-tabs">
           <button class="tab active" onclick="switchTab('skills','installed')">Installed</button>
           <button class="tab" onclick="switchTab('skills','browse')">Browse Registry</button>
@@ -1206,6 +1212,9 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
     <!-- WORKFLOWS PANEL -->
     <div id="panel-workflows" class="panel">
       <div class="panel-body">
+        <div style="margin-bottom:16px;">
+          <p class="settings-desc" style="margin-bottom:0;">Automate multi-step tasks by chaining actions together. Use pre-built recipes, ask Zubo to create one in chat, or build visually with drag-and-drop.</p>
+        </div>
         <div class="tab-bar" id="workflows-tabs">
           <button class="tab active" onclick="switchTab('workflows','recipes')">Recipes</button>
           <button class="tab" onclick="switchTab('workflows','custom')">Custom Workflows</button>
@@ -1305,6 +1314,9 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
     <!-- MCP MARKETPLACE PANEL -->
     <div id="panel-mcp" class="panel">
       <div class="panel-body">
+        <div style="margin-bottom:16px;">
+          <p class="settings-desc" style="margin-bottom:0;">Extensions use the <strong>MCP (Model Context Protocol)</strong> standard to give Zubo new tools — like accessing files, databases, GitHub, and more. Browse the marketplace or add your own.</p>
+        </div>
         <div class="tab-bar" id="mcp-tabs">
           <button class="tab active" onclick="switchTab('mcp','installed')">Installed</button>
           <button class="tab" onclick="switchTab('mcp','marketplace')">Marketplace</button>
@@ -1314,22 +1326,22 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
           <div id="mcp-installed-list" style="display:flex;flex-direction:column;gap:12px;"></div>
           <div id="mcp-installed-empty" class="empty-state-card" style="display:none;">
             <div class="empty-icon"><svg width="64" height="64" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="6" width="20" height="12" rx="2"/><path d="M6 12h4"/><path d="M14 12h4"/></svg></div>
-            <h4>No MCP servers installed</h4>
-            <p>Browse the marketplace to add powerful tool servers.</p>
+            <h4>No extensions installed</h4>
+            <p>Browse the marketplace to add powerful extensions.</p>
             <button class="btn btn-primary" onclick="switchTab('mcp','marketplace')">Browse Marketplace</button>
           </div>
         </div>
 
         <div class="tab-content" id="mcp-tab-marketplace">
           <div class="search-bar">
-            <input id="mcp-marketplace-search" type="text" placeholder="Search MCP servers (e.g. filesystem, github, database...)" onkeydown="if(event.key==='Enter')searchMcpMarketplace()">
+            <input id="mcp-marketplace-search" type="text" placeholder="Search extensions (e.g. filesystem, github, database...)" onkeydown="if(event.key==='Enter')searchMcpMarketplace()">
             <button class="btn btn-primary" onclick="searchMcpMarketplace()">Search</button>
           </div>
           <div class="mcp-marketplace-grid" id="mcp-marketplace-results"></div>
           <div id="mcp-marketplace-empty" class="empty-state-card">
             <div class="empty-icon"><svg width="64" height="64" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg></div>
-            <h4>Discover MCP Servers</h4>
-            <p>Search the official MCP registry to find and install tool servers.</p>
+            <h4>Discover Extensions</h4>
+            <p>Search the marketplace to find and install extensions.</p>
           </div>
         </div>
       </div>
@@ -1398,12 +1410,12 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
           <button class="tab active" onclick="switchTab('settings','general')">General</button>
           <button class="tab" onclick="switchTab('settings','providers')">Providers</button>
           <button class="tab" onclick="switchTab('settings','channels')">Channels</button>
-          <button class="tab" onclick="switchTab('settings','mcp')">MCP</button>
-          <button class="tab" onclick="switchTab('settings','routing')">Routing</button>
+          <button class="tab" onclick="switchTab('settings','mcp')">Extensions</button>
+          <button class="tab" onclick="switchTab('settings','routing')">Cost Savings</button>
           <button class="tab" onclick="switchTab('settings','data')">Data</button>
-          <button class="tab" onclick="switchTab('settings','secrets')">Secrets</button>
-          <button class="tab" onclick="switchTab('settings','system')">System Prompt</button>
-          <button class="tab" onclick="switchTab('settings','cron')">Cron</button>
+          <button class="tab" onclick="switchTab('settings','secrets')">API Keys</button>
+          <button class="tab" onclick="switchTab('settings','system')">Personality</button>
+          <button class="tab" onclick="switchTab('settings','cron')">Scheduled Tasks</button>
           <button class="tab" onclick="switchTab('settings','logs')">Logs</button>
           <button class="tab" onclick="switchTab('settings','privacy')">Privacy</button>
           <button class="tab" onclick="switchTab('settings','budget')">Budget</button>
@@ -1413,11 +1425,11 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
         <!-- General Tab -->
         <div class="tab-content active" id="settings-tab-general">
           <div class="settings-section">
-            <h3 class="settings-title" data-tooltip="Select which AI model powers Zubo">LLM Provider</h3>
-            <p class="settings-desc">Select which provider and model Zubo uses.</p>
+            <h3 class="settings-title" data-tooltip="Choose which AI powers your agent">AI Model</h3>
+            <p class="settings-desc">Choose which AI service and model your agent uses for conversations.</p>
             <div class="settings-grid">
               <div class="settings-field">
-                <label class="settings-label" data-tooltip="Cloud AI service" for="settings-provider">Provider</label>
+                <label class="settings-label" data-tooltip="AI service (e.g. Anthropic, OpenAI)" for="settings-provider">Provider</label>
                 <select id="settings-provider" class="settings-select" onchange="onProviderChange()"></select>
               </div>
               <div class="settings-field">
@@ -1433,11 +1445,11 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
           </div>
 
           <div class="settings-section">
-            <h3 class="settings-title" data-tooltip="Background task frequency">Heartbeat Interval</h3>
-            <p class="settings-desc">How often the background heartbeat runs. Default: 30 minutes.</p>
+            <h3 class="settings-title" data-tooltip="How often Zubo checks for tasks">Background Check Interval</h3>
+            <p class="settings-desc">How often Zubo checks for reminders, scheduled tasks, and updates. Default: every 30 minutes.</p>
             <div class="settings-grid">
               <div class="settings-field">
-                <label class="settings-label" data-tooltip="Minutes between heartbeats" for="settings-heartbeat">Interval (minutes)</label>
+                <label class="settings-label" data-tooltip="Minutes between checks" for="settings-heartbeat">Interval (minutes)</label>
                 <input id="settings-heartbeat" type="number" class="settings-input" min="1" max="1440" step="1" placeholder="30">
               </div>
             </div>
@@ -1456,8 +1468,8 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
         <!-- Providers Tab -->
         <div class="tab-content" id="settings-tab-providers">
           <div class="settings-section">
-            <h3 class="settings-title">LLM Providers</h3>
-            <p class="settings-desc">Configure AI model providers. Set one as active for immediate use.</p>
+            <h3 class="settings-title">AI Providers</h3>
+            <p class="settings-desc">Configure AI services. Set one as active for your agent to use.</p>
             <div id="providers-list" style="display:flex;flex-direction:column;gap:12px;"></div>
             <div style="margin-top:20px;">
               <button class="btn btn-primary" onclick="showAddProviderForm()">Add Provider</button>
@@ -1468,22 +1480,23 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
                 <div class="settings-field">
                   <label class="settings-label" for="new-provider-name">Provider</label>
                   <select id="new-provider-name" class="settings-select" onchange="onNewProviderSelect()">
-                    <option value="">-- Select --</option>
-                    <option value="anthropic">Anthropic</option>
-                    <option value="openai">OpenAI</option>
-                    <option value="groq">Groq</option>
-                    <option value="together">Together</option>
-                    <option value="openrouter">OpenRouter</option>
+                    <option value="">-- Select a provider --</option>
+                    <option value="anthropic">Anthropic (Claude)</option>
+                    <option value="openai">OpenAI (GPT)</option>
+                    <option value="groq">Groq (fast, free tier)</option>
+                    <option value="together">Together AI</option>
+                    <option value="openrouter">OpenRouter (many models)</option>
                     <option value="deepseek">DeepSeek</option>
                     <option value="xai">xAI (Grok)</option>
-                    <option value="ollama">Ollama (local)</option>
-                    <option value="lmstudio">LM Studio (local)</option>
-                    <option value="custom">Custom (OpenAI-compat)</option>
+                    <option value="ollama">Ollama (free, runs locally)</option>
+                    <option value="lmstudio">LM Studio (free, runs locally)</option>
+                    <option value="custom">Custom (advanced)</option>
                   </select>
                 </div>
                 <div class="settings-field">
                   <label class="settings-label" for="new-provider-key">API Key</label>
                   <input id="new-provider-key" type="password" class="settings-input" placeholder="sk-...">
+                  <span id="provider-key-help" class="settings-hint" style="font-size:11px;color:var(--text-faint);margin-top:4px;display:none;"></span>
                 </div>
                 <div class="settings-field">
                   <label class="settings-label" for="new-provider-model">Model</label>
@@ -1532,14 +1545,14 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
         <!-- MCP Tab -->
         <div class="tab-content" id="settings-tab-mcp">
           <div class="settings-section">
-            <h3 class="settings-title">MCP Servers</h3>
-            <p class="settings-desc">Model Context Protocol servers extend Zubo with additional tools. Changes apply immediately.</p>
+            <h3 class="settings-title">Extensions</h3>
+            <p class="settings-desc">Extensions give Zubo new abilities like accessing files, databases, and APIs. Install from the marketplace or add manually.</p>
             <div id="mcp-servers-list" style="display:flex;flex-direction:column;gap:12px;"></div>
             <div style="margin-top:20px;">
-              <button class="btn btn-primary" onclick="showAddMcpForm()">Add MCP Server</button>
+              <button class="btn btn-primary" onclick="showAddMcpForm()">Add Extension</button>
             </div>
             <div id="mcp-add-form" style="display:none;margin-top:16px;padding:16px;background:var(--bg-surface);border:1px solid var(--border);border-radius:var(--radius);">
-              <h4 style="margin-bottom:12px;font-family:var(--display);font-weight:600;">Add MCP Server</h4>
+              <h4 style="margin-bottom:12px;font-family:var(--display);font-weight:600;">Add Extension</h4>
               <div class="settings-grid">
                 <div class="settings-field">
                   <label class="settings-label" for="mcp-name">Name</label>
@@ -1570,8 +1583,8 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
         <!-- Routing Tab -->
         <div class="tab-content" id="settings-tab-routing">
           <div class="settings-section">
-            <h3 class="settings-title" data-tooltip="Route simple queries to a cheaper/faster model">Smart Routing</h3>
-            <p class="settings-desc">Automatically route simple queries to a fast, cheap model and complex ones to your primary model. Saves cost without sacrificing quality.</p>
+            <h3 class="settings-title" data-tooltip="Use a cheaper AI for simple questions">Smart Cost Savings</h3>
+            <p class="settings-desc">Use a cheaper, faster AI for simple questions and your main AI for complex ones. Saves money without sacrificing quality.</p>
             <div class="settings-grid">
               <div class="settings-field">
                 <label class="settings-label" for="sr-enabled">Enabled</label>
@@ -1615,8 +1628,8 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
         <!-- Secrets Tab -->
         <div class="tab-content" id="settings-tab-secrets">
           <div class="settings-section" style="max-width:700px;">
-            <h3 class="settings-title">Secrets &amp; API Keys</h3>
-            <p class="settings-desc">Manage API keys and credentials for integrations. Values are stored encrypted in your local database and never sent to external services by Zubo.</p>
+            <h3 class="settings-title">API Keys &amp; Credentials</h3>
+            <p class="settings-desc">Manage API keys for integrations. Your keys are encrypted and stored securely on your device — Zubo never sends them anywhere.</p>
             <div style="display:flex;gap:10px;margin-bottom:16px;flex-wrap:wrap;">
               <button class="btn btn-primary" onclick="showAddSecretForm()">Add Secret</button>
               <button class="btn btn-ghost" onclick="loadSecrets()">Refresh</button>
@@ -1648,6 +1661,7 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
 
         <!-- System Prompt Tab -->
         <div class="tab-content" id="settings-tab-system">
+          <p class="settings-desc" style="margin-bottom:12px;">Customize your agent&#39;s personality and instructions. This controls how Zubo thinks and responds. Be careful — incorrect changes may cause errors.</p>
           <div class="editor-wrap" style="min-height:calc(100vh - 220px);">
             <div class="editor-toolbar">
               <button class="btn btn-primary" onclick="saveSystem()">Save</button>
@@ -1728,7 +1742,7 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
           <div class="cards" id="budget-summary-cards"></div>
           <div class="settings-section" style="margin-top:24px;">
             <h3 class="settings-title">Budget Limits</h3>
-            <p class="settings-desc">Set spending limits to control costs. The agent will pause when limits are reached.</p>
+            <p class="settings-desc">Set spending limits to control costs. Zubo will stop responding when limits are reached — you can raise them anytime. Typical usage: ~100 messages/day costs $0.50–$2.00 depending on your AI model.</p>
             <div class="settings-grid">
               <div class="settings-field">
                 <label class="settings-label" for="budget-daily">Daily Limit (USD)</label>
@@ -1907,7 +1921,7 @@ export const DASHBOARD_HTML = `<!DOCTYPE html>
 <script>
 // --- Panel routing ---
 var panelNames = ['agent','history','dashboard','memory','skills','workflows','webhooks','mcp','integrations','settings'];
-var panelTitles = { agent:'Chat', history:'History', dashboard:'Dashboard', memory:'Memory', skills:'Skills', workflows:'Workflows', webhooks:'Webhooks', mcp:'MCP', integrations:'Integrations', settings:'Settings' };
+var panelTitles = { agent:'Chat', history:'History', dashboard:'Dashboard', memory:'Knowledge', skills:'Skills', workflows:'Workflows', webhooks:'Webhooks', mcp:'Extensions', integrations:'Integrations', settings:'Settings' };
 
 // Legacy panel name mapping (old names -> new names + tab)
 var legacyPanelMap = {
@@ -3790,10 +3804,28 @@ function onNewProviderSelect() {
   document.getElementById('new-provider-url-field').style.display = showUrl ? '' : 'none';
   // Local providers don't need API key
   var keyInput = document.getElementById('new-provider-key');
+  var helpEl = document.getElementById('provider-key-help');
   if (name === 'ollama' || name === 'lmstudio') {
-    keyInput.placeholder = 'Optional for local providers';
+    keyInput.placeholder = 'Not needed for local models';
+    helpEl.style.display = 'none';
   } else {
     keyInput.placeholder = 'sk-...';
+    // Show where to get the API key
+    var keyLinks = {
+      anthropic: 'console.anthropic.com/settings/keys',
+      openai: 'platform.openai.com/api-keys',
+      groq: 'console.groq.com/keys',
+      together: 'api.together.xyz/settings/api-keys',
+      openrouter: 'openrouter.ai/keys',
+      deepseek: 'platform.deepseek.com/api_keys',
+      xai: 'console.x.ai'
+    };
+    if (keyLinks[name]) {
+      helpEl.textContent = 'Get your key at ' + keyLinks[name];
+      helpEl.style.display = 'block';
+    } else {
+      helpEl.style.display = 'none';
+    }
   }
 }
 
@@ -3857,7 +3889,7 @@ function loadMcpServers() {
     if (!servers.length) {
       var empty = document.createElement('div');
       empty.className = 'empty-state';
-      empty.textContent = 'No MCP servers configured. Add one to extend Zubo with new tools.';
+      empty.textContent = 'No extensions configured. Add one to extend Zubo with new tools.';
       list.appendChild(empty);
       return;
     }
@@ -3921,7 +3953,7 @@ function restartMcpServer(name) {
 }
 
 function removeMcpServer(name) {
-  if (!confirm('Remove MCP server "' + name + '"? This will disconnect it.')) return;
+  if (!confirm('Remove extension "' + name + '"? This will disconnect it.')) return;
   api('/mcp/servers/' + encodeURIComponent(name), { method: 'DELETE' }).then(function(data) {
     if (data.ok) {
       toast(name + ' removed');
@@ -4363,19 +4395,19 @@ function renderCmdResults(query) {
   var subTabs = [
     { title: 'Analytics', action: function() { showPanel('dashboard'); switchTab('dashboard','analytics'); } },
     { title: 'Performance', action: function() { showPanel('dashboard'); switchTab('dashboard','performance'); } },
-    { title: 'System Prompt', action: function() { showPanel('settings'); switchTab('settings','system'); } },
-    { title: 'Cron Jobs', action: function() { showPanel('settings'); switchTab('settings','cron'); } },
+    { title: 'Personality', action: function() { showPanel('settings'); switchTab('settings','system'); } },
+    { title: 'Scheduled Tasks', action: function() { showPanel('settings'); switchTab('settings','cron'); } },
     { title: 'Logs', action: function() { showPanel('settings'); switchTab('settings','logs'); } },
     { title: 'Privacy & Data', action: function() { showPanel('settings'); switchTab('settings','privacy'); } },
     { title: 'Budget', action: function() { showPanel('settings'); switchTab('settings','budget'); } },
-    { title: 'Secrets', action: function() { showPanel('settings'); switchTab('settings','secrets'); } },
+    { title: 'API Keys', action: function() { showPanel('settings'); switchTab('settings','secrets'); } },
     { title: 'Channels', action: function() { showPanel('settings'); switchTab('settings','channels'); } },
     { title: 'Providers', action: function() { showPanel('settings'); switchTab('settings','providers'); } },
-    { title: 'MCP Servers', action: function() { showPanel('settings'); switchTab('settings','mcp'); } },
-    { title: 'Smart Routing', action: function() { showPanel('settings'); switchTab('settings','routing'); } },
+    { title: 'Extensions', action: function() { showPanel('settings'); switchTab('settings','mcp'); } },
+    { title: 'Cost Savings', action: function() { showPanel('settings'); switchTab('settings','routing'); } },
     { title: 'Browse Registry', action: function() { showPanel('skills'); switchTab('skills','browse'); } },
     { title: 'Visual Builder', action: function() { showPanel('workflows'); switchTab('workflows','visual'); } },
-    { title: 'MCP Marketplace', action: function() { showPanel('mcp'); switchTab('mcp','marketplace'); } },
+    { title: 'Extensions Marketplace', action: function() { showPanel('mcp'); switchTab('mcp','marketplace'); } },
     { title: 'Email Digests', action: function() { showPanel('settings'); switchTab('settings','digests'); } },
   ];
   subTabs.forEach(function(st) { items.push({ name: st.title.toLowerCase(), title: st.title, action: st.action }); });
@@ -4516,7 +4548,7 @@ function clearChatMessages() {
   subtext.textContent = 'Ask me anything, or try a suggestion below';
   var chipsGroup = document.createElement('div');
   chipsGroup.className = 'suggestion-chips-group';
-  var rows = [['What can you do?','Check my schedule'],['Summarize recent emails','Set a reminder']];
+  var rows = [['What can you do?','Set a reminder for tomorrow'],['Help me write an email','Explain something to me']];
   rows.forEach(function(rowLabels) {
     var row = document.createElement('div');
     row.className = 'chip-row';

package/src/channels/webchat.ts

@@ -18,22 +18,22 @@ function escapeHtml(s: string): string {
 }
 
 /** Convert raw error messages to user-friendly messages. Prevents leaking internal details. */
-function friendlyError(err: any): string {
-  const msg = err?.message ?? String(err);
-  if (msg.includes("401") || msg.includes("Unauthorized") || msg.includes("invalid"))
-    return "API authentication failed. Check your API key in the dashboard settings.";
-  if (msg.includes("429") || msg.includes("rate limit"))
-    return "Rate limit reached. Please wait a moment and try again.";
-  if (msg.includes("404") || msg.includes("not found"))
-    return "Model not found. Check your model name in settings.";
-  if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("Connection refused"))
-    return "Cannot reach the AI provider. Make sure the server is running.";
-  if (msg.includes("timed out") || msg.includes("timeout"))
-    return "Request timed out. The AI provider may be overloaded — try again.";
-  if (msg.includes("context") || msg.includes("too long"))
-    return "Message too long for the model's context window. Try a shorter message.";
-  return "Something went wrong. Check the logs for details.";
-}
+function friendlyError(err: any): string {
+  const msg = err?.message ?? String(err);
+  if (msg.includes("401") || msg.includes("Unauthorized") || msg.includes("invalid"))
+    return "Authentication failed. Check your API key in Settings > API Keys.";
+  if (msg.includes("429") || msg.includes("rate limit"))
+    return "Too many messages too quickly. Wait a moment and try again.";
+  if (msg.includes("404") || msg.includes("not found"))
+    return "The AI model wasn't found. Check your model name in Settings > AI Model.";
+  if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("Connection refused"))
+    return "Can't reach the AI service. Check your internet connection or try again.";
+  if (msg.includes("timed out") || msg.includes("timeout"))
+    return "The request took too long. The AI service may be busy — try again in a moment.";
+  if (msg.includes("context") || msg.includes("too long"))
+    return "Your message is too long. Try splitting it into shorter questions.";
+  return "Something went wrong. Try again, or check Settings if this keeps happening.";
+}
 
 /** Add security headers to all HTTP responses */
 function addSecurityHeaders(res: Response): Response {

package/src/llm/claude-code.ts

@@ -11,7 +11,7 @@ export class ClaudeCodeProvider implements LlmProvider {
   model: string;
   contextWindow = 200_000;
 
-  constructor(model: string = "claude-sonnet-4-5-20250929") {
+  constructor(model: string = "default") {
     this.model = model;
   }
 
@@ -55,7 +55,6 @@ export class ClaudeCodeProvider implements LlmProvider {
     const prompt = parts.join("\n\n");
 
     const args = ["claude", "-p", prompt, "--output-format", "json"];
-    if (this.model) args.push("--model", this.model);
 
     try {
       const proc = Bun.spawn(args, {

package/src/llm/codex.ts

@@ -11,7 +11,7 @@ export class CodexProvider implements LlmProvider {
   model: string;
   contextWindow = 200_000;
 
-  constructor(model: string = "o4-mini") {
+  constructor(model: string = "default") {
     this.model = model;
   }
 
@@ -52,7 +52,6 @@ export class CodexProvider implements LlmProvider {
     const prompt = parts.join("\n\n");
 
     const args = ["codex", "exec"];
-    if (this.model) args.push("--model", this.model);
     args.push(prompt);
 
     try {

package/src/setup-web.html.ts

@@ -588,10 +588,10 @@ export const SETUP_WIZARD_HTML = `<!DOCTYPE html>
   </div>
 
   <div class="stepper" id="stepper">
-    <div class="stepper-item active" data-step="1"><div class="stepper-dot">1</div><span>Provider</span></div>
+    <div class="stepper-item active" data-step="1"><div class="stepper-dot">1</div><span>AI Provider</span></div>
     <div class="stepper-item" data-step="2"><div class="stepper-dot">2</div><span>Channels</span></div>
-    <div class="stepper-item" data-step="3"><div class="stepper-dot">3</div><span>Agent</span></div>
-    <div class="stepper-item" data-step="4"><div class="stepper-dot">4</div><span>Routing</span></div>
+    <div class="stepper-item" data-step="3"><div class="stepper-dot">3</div><span>Personalize</span></div>
+    <div class="stepper-item" data-step="4"><div class="stepper-dot">4</div><span>Cost Savings</span></div>
   </div>
 
   <div class="step-panel" id="stepPanel">
@@ -725,8 +725,8 @@ function prevStep() {
 
 // ── Step 1: Provider ──
 function renderProvider() {
-  var html = '<h3 class="step-title">LLM Provider</h3>';
-  html += '<p class="step-desc">Choose the AI provider that powers your agent.</p>';
+  var html = '<h3 class="step-title">AI Provider</h3>';
+  html += '<p class="step-desc">Choose the AI service that powers your agent.</p>';
   html += '<div class="provider-grid">';
   PROVIDERS.forEach(function(p) {
     html += '<div class="provider-card' + (state.activeProvider === p.id ? ' selected' : '') + '" data-pid="' + p.id + '">';
@@ -978,7 +978,7 @@ function collectProviderData() {
   if (!p) return;
 
   if (p.cli) {
-    var model = p.id === 'claude-code' ? 'claude-sonnet-4-5-20250929' : 'o4-mini';
+    var model = 'default';
     state.providers[p.id] = { model: model };
   } else if (p.local) {
     var m = document.getElementById('model')?.value || p.defaultModel;
@@ -1006,7 +1006,7 @@ function collectProviderData() {
     var fb = PROVIDERS.find(function(x) { return x.id === state.fallbackProvider; });
     if (fb) {
       if (fb.cli) {
-        var fbm = fb.id === 'claude-code' ? 'claude-sonnet-4-5-20250929' : 'o4-mini';
+        var fbm = 'default';
         state.providers[fb.id] = { model: fbm };
       } else if (fb.local) {
         var fbModel = document.getElementById('fb_model')?.value || fb.defaultModel;
@@ -1149,9 +1149,9 @@ function collectAgentData() {
 
 // ── Step 4: Smart Routing ──
 function renderRouting() {
-  var html = '<h3 class="step-title">Smart Routing</h3>';
+  var html = '<h3 class="step-title">Smart Cost Savings</h3>';
   html += '<div class="routing-card">';
-  html += '<p>Smart routing sends simple queries (greetings, one-liners) to a fast, cheap model \\u{2014} and uses your main provider for complex tasks. This can save 50-80% on API costs.</p>';
+  html += '<p>Use a cheaper, faster AI for simple questions (greetings, one-liners) and your main AI for complex tasks. This can save 50-80% on costs.</p>';
 
   var hasSecondProvider = state.failover.length > 0;
 

package/src/setup.ts

@@ -350,12 +350,12 @@ const PROVIDER_OPTIONS: ProviderOption[] = [
         console.log(`    ${DIM}npm install -g @anthropic-ai/claude-code${RESET}\n`);
         const cont = await prompt("  Press Enter after installing, or 'skip' to continue anyway: ");
         if (cont.toLowerCase() === "skip") {
-          return { name: "claude-code", config: { model: "claude-sonnet-4-5-20250929" } };
+          return { name: "claude-code", config: { model: "default" } };
         }
         const recheck = Bun.spawnSync(["which", "claude"], { stdout: "pipe", stderr: "pipe" });
         if (recheck.exitCode !== 0) {
           warn("Still not found. Config saved — install 'claude' CLI before starting.");
-          return { name: "claude-code", config: { model: "claude-sonnet-4-5-20250929" } };
+          return { name: "claude-code", config: { model: "default" } };
         }
       }
       ok("'claude' CLI found");
@@ -380,7 +380,7 @@ const PROVIDER_OPTIONS: ProviderOption[] = [
           warn("Still not authenticated. Run 'claude' in a terminal to log in before starting Zubo.");
         }
       }
-      return { name: "claude-code", config: { model: "claude-sonnet-4-5-20250929" } };
+      return { name: "claude-code", config: { model: "default" } };
     },
   },
   {
@@ -394,12 +394,12 @@ const PROVIDER_OPTIONS: ProviderOption[] = [
         console.log(`    ${DIM}npm install -g @openai/codex${RESET}\n`);
         const cont = await prompt("  Press Enter after installing, or 'skip' to continue anyway: ");
         if (cont.toLowerCase() === "skip") {
-          return { name: "codex", config: { model: "o4-mini" } };
+          return { name: "codex", config: { model: "default" } };
         }
         const recheck = Bun.spawnSync(["which", "codex"], { stdout: "pipe", stderr: "pipe" });
         if (recheck.exitCode !== 0) {
           warn("Still not found. Config saved — install 'codex' CLI before starting.");
-          return { name: "codex", config: { model: "o4-mini" } };
+          return { name: "codex", config: { model: "default" } };
         }
       }
       ok("'codex' CLI found");
@@ -412,7 +412,7 @@ const PROVIDER_OPTIONS: ProviderOption[] = [
       } else {
         ok("Codex ready");
       }
-      return { name: "codex", config: { model: "o4-mini" } };
+      return { name: "codex", config: { model: "default" } };
     },
   },
   {

package/src/tools/executor.ts

@@ -121,7 +121,7 @@ export async function executeTool(
     logger.warn(`Tool blocked by allowedTools: ${name}`);
     return {
       tool_use_id: toolUseId,
-      content: `Error: Tool '${name}' is not available in this agent context.`,
+      content: `Error: The '${name}' feature is not available right now.`,
       is_error: true,
     };
   }
@@ -141,7 +141,7 @@ export async function executeTool(
     logger.warn(`Tool denied: ${name}`);
     return {
       tool_use_id: toolUseId,
-      content: `Error: Tool '${name}' is not permitted.`,
+      content: `Error: The '${name}' feature is not permitted. You can change permissions in Settings.`,
       is_error: true,
     };
   }

package/src/tools/mcp-registry.ts

@@ -46,7 +46,7 @@ export async function searchRegistry(
   if (cached) return cached;
 
   try {
-    const url = `${BASE_URL}/servers?q=${encodeURIComponent(query)}&limit=${limit}`;
+    const url = `${BASE_URL}/servers?search=${encodeURIComponent(query)}&limit=${limit}`;
     const res = await fetch(url);
     if (!res.ok) {
       logger.warn(`MCP registry search failed: ${res.status} ${res.statusText}`);