npm - zubo - Versions diffs - 0.1.3 → 0.1.5 - Mend

zubo 0.1.3 → 0.1.5

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 (10) hide show

package/.dockerignore +12 -0
package/Dockerfile +24 -0
package/docker-compose.yml +20 -0
package/package.json +1 -1
package/site/docs/index.html +59 -11
package/site/index.html +154 -61
package/site/script.js +14 -5
package/site/style.css +38 -0
package/src/tools/builtin-integrations/google/gmail/handler.ts +8 -2
package/src/tools/builtin-skills/http-request/handler.ts +7 -1

package/.dockerignore ADDED Viewed

@@ -0,0 +1,12 @@
+node_modules
+dist
+desktop
+site
+.env
+.env.*
+.zubo
+.git
+.DS_Store
+*.db
+*.db-wal
+*.db-shm

package/Dockerfile ADDED Viewed

@@ -0,0 +1,24 @@
+# Zubo — Dockerfile
+# Runs the Zubo AI agent using the official Bun runtime image.
+# Persistent data (config, database, memory, skills) lives in /root/.zubo
+# and should be mounted as a volume.
+FROM oven/bun:1
+WORKDIR /app
+# Install dependencies first (layer cache optimisation)
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
+# Copy the rest of the project
+COPY . .
+# Webchat dashboard port
+EXPOSE 8787
+# Persistent storage mount point — config.json, zubo.db, workspace, logs, etc.
+VOLUME /root/.zubo
+# Start the agent
+CMD ["bun", "run", "src/index.ts", "start"]

package/docker-compose.yml ADDED Viewed

@@ -0,0 +1,20 @@
+# Zubo — Docker Compose
+# Usage:
+#   1. Copy .env.example to .env and fill in your API keys
+#   2. docker compose up -d
+#   3. Open http://localhost:8787 for the webchat dashboard
+services:
+  zubo:
+    build: .
+    container_name: zubo
+    restart: unless-stopped
+    ports:
+      - "8787:8787"   # Webchat dashboard
+    volumes:
+      - ~/.zubo:/root/.zubo   # Persistent data (config, DB, memory, skills, logs)
+    env_file:
+      - .env   # API keys: ANTHROPIC_API_KEY, OPENAI_API_KEY, TELEGRAM_BOT_TOKEN, etc.

package/package.json CHANGED Viewed

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

package/site/docs/index.html CHANGED Viewed

@@ -4,18 +4,18 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Getting Started — Zubo Docs</title>
-  <meta name="description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, multi-channel presence, 35+ tools, sub-agent delegation, and workflow automation.">
+  <meta name="description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, multi-channel presence, 20+ tools, sub-agent delegation, and workflow automation.">
   <meta name="theme-color" content="#060608">
   <link rel="canonical" href="https://zubo.bot/docs/">
   <meta property="og:title" content="Getting Started — Zubo Docs">
-  <meta property="og:description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, multi-channel presence, 35+ tools, sub-agent delegation, and workflow automation.">
+  <meta property="og:description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, multi-channel presence, 20+ tools, sub-agent delegation, and workflow automation.">
   <meta property="og:type" content="article">
   <meta property="og:url" content="https://zubo.bot/docs/">
   <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="Getting Started — Zubo Docs">
-  <meta name="twitter:description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, 35+ tools, and workflow automation.">
+  <meta name="twitter:description" content="Get started with Zubo, a self-hosted AI agent with persistent semantic memory, 20+ tools, and workflow automation.">
   <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">
@@ -87,7 +87,7 @@
       <h1>Getting Started with Zubo</h1>
       <p>
-        Zubo is a self-hosted AI agent with persistent semantic memory, multi-channel presence across Telegram, Discord, Slack, WhatsApp, Signal, and Web Chat, over 35 smart built-in tools, sub-agent delegation, and workflow automation. It runs entirely on your machine &mdash; your data never leaves your infrastructure. Whether you need a personal assistant that remembers everything, an automation hub that connects your services, or an AI copilot embedded in every chat platform you use, Zubo handles it from a single process with a single configuration file.
+        Zubo is a self-hosted AI agent with persistent semantic memory, multi-channel presence across Telegram, Discord, Slack, WhatsApp, Signal, and Web Chat, 20+ smart built-in tools, sub-agent delegation, and workflow automation. It runs entirely on your machine &mdash; your data never leaves your infrastructure. Whether you need a personal assistant that remembers everything, an automation hub that connects your services, or an AI copilot embedded in every chat platform you use, Zubo handles it from a single process with a single configuration file.
       </p>
       <!-- ================================================================ -->
@@ -125,7 +125,7 @@
       <h3>Tools</h3>
       <ul>
-        <li><strong>35+ built-in tools</strong> including shell command execution, file I/O (read, write, list, search), web search (DuckDuckGo, Brave, Google), HTTP requests, memory read/write/search, secrets management, and cron job scheduling.</li>
+        <li><strong>20+ built-in tools</strong> including shell command execution, file I/O (read, write, list, search), web search (DuckDuckGo, Brave, Google), HTTP requests, memory read/write/search, secrets management, and cron job scheduling.</li>
         <li>Tools are permission-gated with three levels: <code>safe</code>, <code>sensitive</code>, and <code>dangerous</code>. Dangerous operations require explicit confirmation tokens.</li>
       </ul>
@@ -200,21 +200,69 @@
       <!-- ================================================================ -->
       <h2 id="installation">Installation</h2>
+      <p>Choose the installation method that fits your platform.</p>
+      <h3 id="install-mac-linux">macOS &amp; Linux</h3>
       <p>Zubo requires <strong>Bun v1.0+</strong> as its runtime. If you do not have Bun installed, visit <a href="https://bun.sh" target="_blank" rel="noopener">bun.sh</a> and run the one-line installer.</p>
-      <h3>Step 1: Install Zubo</h3>
+      <p><strong>One-liner (recommended):</strong></p>
+<pre><code>curl -fsSL https://zubo.bot/install.sh | bash</code></pre>
-      <p>Install Zubo globally using Bun (recommended) or npm:</p>
+      <p>This installs Bun (if needed), installs Zubo globally, and runs the setup wizard automatically.</p>
+      <p><strong>Manual install:</strong></p>
 <pre><code># Using Bun (recommended)
 bun add -g zubo
 # Or using npm
-npm i -g zubo</code></pre>
+npm i -g zubo
+# Then run the setup wizard
+zubo setup</code></pre>
+      <h3 id="install-windows">Windows (via WSL)</h3>
+      <p>Zubo runs on Windows through the Windows Subsystem for Linux (WSL). This gives you full compatibility with zero workarounds.</p>
+      <p><strong>Step 1:</strong> Install WSL (requires Windows 10 version 2004+ or Windows 11):</p>
+<pre><code>wsl --install</code></pre>
+      <p>Restart your computer when prompted. This installs Ubuntu by default.</p>
+      <p><strong>Step 2:</strong> Open the Ubuntu terminal from the Start Menu and install Zubo:</p>
+<pre><code>curl -fsSL https://zubo.bot/install.sh | bash</code></pre>
+      <p>That's it. Zubo runs inside WSL with full access to all features. The web dashboard is accessible from your Windows browser at <code>http://localhost:3000</code>.</p>
+      <h3 id="install-docker">Docker</h3>
+      <p>Run Zubo as a container with no local dependencies.</p>
+<pre><code># Clone the repo
+git clone https://github.com/apwn/zubo.git &amp;&amp; cd zubo
+# Copy the example env and add your API key
+cp .env.example .env
+# Start Zubo
+docker compose up -d</code></pre>
+      <p>The container exposes port <code>8787</code> for the web dashboard and mounts <code>~/.zubo</code> for persistent data. Stop with <code>docker compose down</code>.</p>
+      <p>To configure, edit <code>.env</code> or mount your own <code>config.json</code>:</p>
+<pre><code>volumes:
+  - ~/.zubo:/root/.zubo
+  - ./my-config.json:/root/.zubo/config.json</code></pre>
-      <p>This places the <code>zubo</code> binary on your PATH, making it available from any terminal session.</p>
+      <h3 id="setup-wizard">The Setup Wizard</h3>
-      <h3>Step 2: Run the Setup Wizard</h3>
+      <p>After installing (on any platform), run the setup wizard:</p>
 <pre><code>zubo setup</code></pre>
@@ -228,7 +276,7 @@ npm i -g zubo</code></pre>
         <li>Create a default <code>SYSTEM.md</code> system prompt that you can customize later.</li>
       </ul>
-      <h3>Step 3: Start Zubo</h3>
+      <h3 id="starting">Starting Zubo</h3>
 <pre><code># Start in foreground (logs to stdout)
 zubo start

package/site/index.html CHANGED Viewed

@@ -3,19 +3,19 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Zubo — The AI Agent That Never Forgets</title>
-  <meta name="description" content="Zubo is a self-hosted AI agent with persistent memory, multi-channel presence, smart tools, and sub-agent delegation. Open source. Runs locally. No cloud required.">
+  <title>Zubo — Your AI Agent. Your Machine. Your Rules.</title>
+  <meta name="description" content="Open-source AI agent that runs on your machine. Persistent memory, 20+ tools, 6 messaging channels, 11+ LLM providers. One install, works everywhere.">
   <meta name="theme-color" content="#060608">
   <link rel="canonical" href="https://zubo.bot/">
-  <meta property="og:title" content="Zubo — The AI Agent That Never Forgets">
-  <meta property="og:description" content="Self-hosted AI agent with persistent memory, multi-channel presence, and 20+ smart tools. Open source, runs locally.">
+  <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, 20+ tools, works across Telegram, Discord, Slack, WhatsApp, and more. 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 — The AI Agent That Never Forgets">
-  <meta name="twitter:description" content="Self-hosted AI agent with persistent memory, multi-channel presence, and 20+ smart tools. Open source, runs locally.">
+  <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, 20+ tools, works across Telegram, Discord, Slack, WhatsApp, and more. 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">
@@ -74,12 +74,12 @@
         <h1 class="hero-title">
           <span class="hero-line">Your AI Agent.</span>
-          <span class="hero-line"><span class="gradient-text">Infinite Memory.</span></span>
+          <span class="hero-line"><span class="gradient-text">Your Machine.</span></span>
         </h1>
         <p class="hero-subtitle">
-          Zubo runs on your machine with persistent semantic memory, multi-channel presence,
-          20+ smart tools, and sub-agent delegation. No cloud. No compromise. No forgetting.
+          Zubo runs on your machine, remembers everything you tell it, works across all your
+          messaging apps, and connects to your favorite tools. No cloud. No subscriptions. No forgetting.
         </p>
         <div class="hero-actions">
@@ -231,8 +231,8 @@
     <div class="container">
       <div class="section-header reveal">
         <span class="section-badge">Capabilities</span>
-        <h2 class="section-title">Everything you need.<br><span class="gradient-text">Nothing you don't.</span></h2>
-        <p class="section-subtitle">Zubo ships with powerful features out of the box &mdash; memory, tools, scheduling, multi-channel support, and more. No plugins needed to get started.</p>
+        <h2 class="section-title">One agent.<br><span class="gradient-text">Endless capabilities.</span></h2>
+        <p class="section-subtitle">Memory, tools, scheduling, multi-channel support &mdash; everything works out of the box. No plugins required.</p>
       </div>
       <div class="bento reveal-stagger">
@@ -272,7 +272,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"><rect x="3" y="11" width="18" height="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/><circle cx="12" cy="16" r="1"/></svg>
           </div>
           <h3>100% Private</h3>
-          <p>Runs entirely on your machine. SQLite database, local vector store. Your conversations never leave your hardware. Set spending limits and track costs per model &mdash; full transparency, zero surprises.</p>
+          <p>Runs entirely on your machine. SQLite database, local vector store. Your conversations never leave your hardware. Your data stays yours.</p>
         </div>
         <!-- Row 2 -->
@@ -280,8 +280,8 @@
           <div class="bento-icon">
             <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
           </div>
-          <h3>Always Watching</h3>
-          <p>Schedule tasks in plain English &mdash; 'every weekday at 9am' just works. Cron jobs, proactive triggers, and automated workflows. Zubo monitors, alerts, and acts on your behalf &mdash; even when you're away.</p>
+          <h3>Runs on Autopilot</h3>
+          <p>Schedule tasks in plain English &mdash; &ldquo;every weekday at 9am&rdquo; just works. Zubo monitors, alerts, and acts on your behalf &mdash; even when you're away.</p>
         </div>
         <div class="bento-card tilt-card" data-feature="extensible">
@@ -297,7 +297,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="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="7.5 4.21 12 6.81 16.5 4.21"/><polyline points="7.5 19.79 7.5 14.6 3 12"/><polyline points="21 12 16.5 14.6 16.5 19.79"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
           </div>
           <h3>Any LLM, Your Choice</h3>
-          <p>Works with Anthropic, OpenAI, Google Gemini, Ollama, Groq, Together, OpenRouter, DeepSeek, xAI, Fireworks, LM Studio, and any OpenAI-compatible provider. Smart routing automatically sends simple queries to fast, cheap models &mdash; saving you money without sacrificing quality.</p>
+          <p>11+ providers including Anthropic, OpenAI, Gemini, Ollama, Groq, DeepSeek, and more. Smart routing sends simple queries to fast, cheap models automatically &mdash; so you save money without thinking about it.</p>
           <div class="bento-models">
             <span class="model-tag">Claude</span>
             <span class="model-tag">GPT-4o</span>
@@ -440,86 +440,179 @@
         <h2 class="section-title">Running in <span class="gradient-text">60 seconds</span>.</h2>
       </div>
-      <div class="qs-terminal glow-border reveal">
-        <div class="qs-chrome">
-          <div class="terminal-dots">
-            <span class="td td-r"></span>
-            <span class="td td-y"></span>
-            <span class="td td-g"></span>
-          </div>
-          <div class="qs-tabs">
-            <button class="qs-tab active" data-tab="one-liner">One-liner</button>
-            <button class="qs-tab" data-tab="bun">bun</button>
-            <button class="qs-tab" data-tab="npm">npm</button>
+      <!-- OS toggle -->
+      <div class="os-toggle reveal">
+        <button class="os-btn active" data-os="mac" onclick="switchOS('mac')">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M18.71 19.5c-.83 1.24-1.71 2.45-3.05 2.47-1.34.03-1.77-.79-3.29-.79-1.53 0-2 .77-3.27.82-1.31.05-2.3-1.32-3.14-2.53C4.25 17 2.94 12.45 4.7 9.39c.87-1.52 2.43-2.48 4.12-2.51 1.28-.02 2.5.87 3.29.87.78 0 2.26-1.07 3.8-.91.65.03 2.47.26 3.64 1.98-.09.06-2.17 1.28-2.15 3.81.03 3.02 2.65 4.03 2.68 4.04-.03.07-.42 1.44-1.38 2.83M13 3.5c.73-.83 1.94-1.46 2.94-1.5.13 1.17-.34 2.35-1.04 3.19-.69.85-1.83 1.51-2.95 1.42-.15-1.15.41-2.35 1.05-3.11z"/></svg>
+          macOS / Linux
+        </button>
+        <button class="os-btn" data-os="windows" onclick="switchOS('windows')">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M0 3.449L9.75 2.1v9.451H0m10.949-9.602L24 0v11.4H10.949M0 12.6h9.75v9.451L0 20.699M10.949 12.6H24V24l-12.9-1.801"/></svg>
+          Windows
+        </button>
+        <button class="os-btn" data-os="docker" onclick="switchOS('docker')">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.186.186 0 00-.185.186v1.887c0 .102.083.185.185.185zm-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.186.186 0 00-.185.185v1.888c0 .102.082.185.185.186zm0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.186.186 0 00-.185.185v1.887c0 .102.082.186.185.186zm-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.186.186 0 00-.185.185v1.887c0 .102.083.186.185.186zm-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.186.186 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.186.186.186zm5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.186v1.887c0 .102.082.185.185.185zm-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.186v1.887c0 .102.083.185.185.185zm-2.964 0h2.119a.186.186 0 00.185-.185V9.006a.186.186 0 00-.185-.186H5.136a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185zm-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185zM23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.687 11.687 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.33 12.33 0 003.544-1.372 10.078 10.078 0 002.506-2.053c1.076-1.223 1.718-2.58 2.198-3.794h.19c1.18 0 1.907-.482 2.31-.882.265-.26.478-.57.625-.916l.087-.252z"/></svg>
+          Docker
+        </button>
+      </div>
+      <!-- macOS / Linux terminal -->
+      <div class="os-content active" data-os-content="mac">
+        <div class="qs-terminal glow-border reveal">
+          <div class="qs-chrome">
+            <div class="terminal-dots">
+              <span class="td td-r"></span>
+              <span class="td td-y"></span>
+              <span class="td td-g"></span>
+            </div>
+            <div class="qs-tabs">
+              <button class="qs-tab active" data-tab="one-liner">One-liner</button>
+              <button class="qs-tab" data-tab="bun">bun</button>
+              <button class="qs-tab" data-tab="npm">npm</button>
+            </div>
+            <div class="qs-chrome-spacer"></div>
+          </div>
+          <div class="qs-body">
+            <div class="qs-pane active" id="qs-one-liner">
+              <div class="qs-line">
+                <span class="qs-comment"># Install and launch in one shot</span>
+              </div>
+              <div class="qs-line qs-cmd">
+                <span class="qs-prompt">$</span>
+                <span class="qs-text">curl -fsSL https://zubo.bot/install.sh | bash</span>
+                <button class="copy-btn" data-copy="curl -fsSL https://zubo.bot/install.sh | bash" aria-label="Copy command">
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                </button>
+              </div>
+            </div>
+            <div class="qs-pane" id="qs-bun">
+              <div class="qs-line">
+                <span class="qs-comment"># Install Zubo</span>
+              </div>
+              <div class="qs-line qs-cmd">
+                <span class="qs-prompt">$</span>
+                <span class="qs-text">bun add -g zubo</span>
+                <button class="copy-btn" data-copy="bun add -g zubo" aria-label="Copy command">
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                </button>
+              </div>
+              <div class="qs-line qs-spacer"></div>
+              <div class="qs-line">
+                <span class="qs-comment"># Meet your new agent</span>
+              </div>
+              <div class="qs-line qs-cmd">
+                <span class="qs-prompt">$</span>
+                <span class="qs-text">zubo setup</span>
+                <button class="copy-btn" data-copy="zubo setup" aria-label="Copy command">
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                </button>
+              </div>
+            </div>
+            <div class="qs-pane" id="qs-npm">
+              <div class="qs-line">
+                <span class="qs-comment"># Install Zubo</span>
+              </div>
+              <div class="qs-line qs-cmd">
+                <span class="qs-prompt">$</span>
+                <span class="qs-text">npm i -g zubo</span>
+                <button class="copy-btn" data-copy="npm i -g zubo" aria-label="Copy command">
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                </button>
+              </div>
+              <div class="qs-line qs-spacer"></div>
+              <div class="qs-line">
+                <span class="qs-comment"># Meet your new agent</span>
+              </div>
+              <div class="qs-line qs-cmd">
+                <span class="qs-prompt">$</span>
+                <span class="qs-text">zubo setup</span>
+                <button class="copy-btn" data-copy="zubo setup" aria-label="Copy command">
+                  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                </button>
+              </div>
+            </div>
           </div>
-          <div class="qs-chrome-spacer"></div>
         </div>
-        <div class="qs-body">
-          <!-- one-liner tab -->
-          <div class="qs-pane active" id="qs-one-liner">
-            <div class="qs-line">
-              <span class="qs-comment"># Install and launch in one shot</span>
-            </div>
-            <div class="qs-line qs-cmd">
-              <span class="qs-prompt">$</span>
-              <span class="qs-text">curl -fsSL https://zubo.bot/install.sh | bash</span>
-              <button class="copy-btn" data-copy="curl -fsSL https://zubo.bot/install.sh | bash" aria-label="Copy command">
-                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
-              </button>
+        <p class="qs-note reveal">Works on macOS &amp; Linux. The installer sets up Bun and everything else for you.</p>
+      </div>
+      <!-- Windows terminal -->
+      <div class="os-content" data-os-content="windows">
+        <div class="qs-terminal glow-border reveal">
+          <div class="qs-chrome">
+            <div class="terminal-dots">
+              <span class="td td-r"></span>
+              <span class="td td-y"></span>
+              <span class="td td-g"></span>
             </div>
+            <div class="terminal-title">PowerShell</div>
+            <div class="qs-chrome-spacer"></div>
           </div>
-          <!-- bun tab -->
-          <div class="qs-pane" id="qs-bun">
+          <div class="qs-body">
             <div class="qs-line">
-              <span class="qs-comment"># Install Zubo</span>
+              <span class="qs-comment"># Install WSL (one-time, requires restart)</span>
             </div>
             <div class="qs-line qs-cmd">
-              <span class="qs-prompt">$</span>
-              <span class="qs-text">bun add -g zubo</span>
-              <button class="copy-btn" data-copy="bun add -g zubo" aria-label="Copy command">
+              <span class="qs-prompt">&gt;</span>
+              <span class="qs-text">wsl --install</span>
+              <button class="copy-btn" data-copy="wsl --install" aria-label="Copy command">
                 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
               </button>
             </div>
             <div class="qs-line qs-spacer"></div>
             <div class="qs-line">
-              <span class="qs-comment"># Meet your new agent</span>
+              <span class="qs-comment"># Then open WSL and install Zubo</span>
             </div>
             <div class="qs-line qs-cmd">
               <span class="qs-prompt">$</span>
-              <span class="qs-text">zubo setup</span>
-              <button class="copy-btn" data-copy="zubo setup" aria-label="Copy command">
+              <span class="qs-text">curl -fsSL https://zubo.bot/install.sh | bash</span>
+              <button class="copy-btn" data-copy="curl -fsSL https://zubo.bot/install.sh | bash" aria-label="Copy command">
                 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
               </button>
             </div>
           </div>
-          <!-- npm tab -->
-          <div class="qs-pane" id="qs-npm">
+        </div>
+        <p class="qs-note reveal">Runs inside WSL (Windows Subsystem for Linux). Full performance, native experience.</p>
+      </div>
+      <!-- Docker terminal -->
+      <div class="os-content" data-os-content="docker">
+        <div class="qs-terminal glow-border reveal">
+          <div class="qs-chrome">
+            <div class="terminal-dots">
+              <span class="td td-r"></span>
+              <span class="td td-y"></span>
+              <span class="td td-g"></span>
+            </div>
+            <div class="terminal-title">Terminal</div>
+            <div class="qs-chrome-spacer"></div>
+          </div>
+          <div class="qs-body">
             <div class="qs-line">
-              <span class="qs-comment"># Install Zubo</span>
+              <span class="qs-comment"># Clone and start with Docker</span>
             </div>
             <div class="qs-line qs-cmd">
               <span class="qs-prompt">$</span>
-              <span class="qs-text">npm i -g zubo</span>
-              <button class="copy-btn" data-copy="npm i -g zubo" aria-label="Copy command">
+              <span class="qs-text">git clone https://github.com/apwn/zubo.git &amp;&amp; cd zubo</span>
+              <button class="copy-btn" data-copy="git clone https://github.com/apwn/zubo.git && cd zubo" aria-label="Copy command">
                 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
               </button>
             </div>
             <div class="qs-line qs-spacer"></div>
             <div class="qs-line">
-              <span class="qs-comment"># Meet your new agent</span>
+              <span class="qs-comment"># Launch Zubo in a container</span>
             </div>
             <div class="qs-line qs-cmd">
               <span class="qs-prompt">$</span>
-              <span class="qs-text">zubo setup</span>
-              <button class="copy-btn" data-copy="zubo setup" aria-label="Copy command">
+              <span class="qs-text">docker compose up -d</span>
+              <button class="copy-btn" data-copy="docker compose up -d" aria-label="Copy command">
                 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
               </button>
             </div>
           </div>
         </div>
+        <p class="qs-note reveal">Works on any OS with Docker. Dashboard at <strong>localhost:8787</strong>.</p>
       </div>
-      <p class="qs-note reveal">Works on macOS &amp; Linux. The installer sets up Bun and everything else for you.</p>
     </div>
   </section>
@@ -552,8 +645,8 @@
     </div>
     <div class="container">
       <div class="cta-content reveal">
-        <h2>Ready to build your <span class="gradient-text">perfect AI agent</span>?</h2>
-        <p>Get started in seconds. Free forever. No credit card needed.</p>
+        <h2>Ready to meet your <span class="gradient-text">new AI agent</span>?</h2>
+        <p>One install. Free and open source. You only pay for the LLM API you choose.</p>
         <div class="cta-actions">
           <a href="#get-started" class="btn btn-primary btn-xl">
             <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
@@ -616,7 +709,7 @@
     "@context": "https://schema.org",
     "@type": "SoftwareApplication",
     "name": "Zubo",
-    "description": "A self-hosted AI agent with persistent semantic memory, multi-channel presence, 35+ smart tools, sub-agent delegation, and workflow automation. Open source, runs locally.",
+    "description": "Open-source AI agent with persistent semantic memory, multi-channel presence, 20+ smart tools, sub-agent delegation, and workflow automation. Runs locally on your machine.",
     "url": "https://zubo.bot",
     "applicationCategory": "DeveloperApplication",
     "operatingSystem": "macOS, Linux, Windows",

package/site/script.js CHANGED Viewed

@@ -3,6 +3,16 @@
    Vanilla JS, zero dependencies
    ============================================ */
+/* OS toggle — must be global for inline onclick handlers */
+function switchOS(os) {
+  document.querySelectorAll('.os-btn').forEach(function (b) { b.classList.remove('active'); });
+  document.querySelectorAll('.os-content').forEach(function (c) { c.classList.remove('active'); });
+  var btn = document.querySelector('.os-btn[data-os="' + os + '"]');
+  if (btn) btn.classList.add('active');
+  var content = document.querySelector('[data-os-content="' + os + '"]');
+  if (content) content.classList.add('active');
+}
 (function () {
   'use strict';
@@ -231,14 +241,13 @@
   });
   /* ------------------------------------------
-     6. Quick Start tab switching
+     6. Quick Start tab switching (within macOS/Linux)
      ------------------------------------------ */
   document.querySelectorAll('.qs-tab').forEach(function (tab) {
     tab.addEventListener('click', function () {
-      // Deactivate all tabs and panes
-      document.querySelectorAll('.qs-tab').forEach(function (t) { t.classList.remove('active'); });
-      document.querySelectorAll('.qs-pane').forEach(function (p) { p.classList.remove('active'); });
-      // Activate clicked tab and matching pane
+      var parent = tab.closest('.os-content') || document;
+      parent.querySelectorAll('.qs-tab').forEach(function (t) { t.classList.remove('active'); });
+      parent.querySelectorAll('.qs-pane').forEach(function (p) { p.classList.remove('active'); });
       tab.classList.add('active');
       var paneId = 'qs-' + tab.getAttribute('data-tab');
       var pane = document.getElementById(paneId);

package/site/style.css CHANGED Viewed

@@ -986,6 +986,44 @@ h1, h2, h3, h4,
   color: #c4b5fd;
 }
 .qs-chrome-spacer { flex: 1; }
+/* OS toggle */
+.os-toggle {
+  display: flex;
+  justify-content: center;
+  gap: 6px;
+  margin-bottom: 24px;
+}
+.os-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  background: rgba(255,255,255,0.04);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 10px 20px;
+  font-family: var(--font);
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--text-muted);
+  cursor: pointer;
+  transition: all 0.25s var(--ease);
+}
+.os-btn:hover {
+  color: var(--text-secondary);
+  border-color: rgba(124, 58, 237, 0.2);
+  background: rgba(255,255,255,0.06);
+}
+.os-btn.active {
+  background: rgba(124, 58, 237, 0.12);
+  border-color: rgba(124, 58, 237, 0.35);
+  color: #c4b5fd;
+}
+.os-btn svg { opacity: 0.7; }
+.os-btn.active svg { opacity: 1; }
+.os-content { display: none; }
+.os-content.active { display: block; }
 .qs-body {
   padding: 28px 28px 32px;
   font-family: var(--mono);

package/src/tools/builtin-integrations/google/gmail/handler.ts CHANGED Viewed

@@ -1,5 +1,11 @@
 const API = "https://gmail.googleapis.com/gmail/v1/users/me";
+/** RFC 2047 encode a header value if it contains non-ASCII characters (e.g. emojis) */
+function mimeEncode(value: string): string {
+  if (/^[\x20-\x7E]*$/.test(value)) return value;
+  return `=?UTF-8?B?${Buffer.from(value, "utf-8").toString("base64")}?=`;
+}
 async function getToken(): Promise<string> {
   const Zubo = (globalThis as any).Zubo;
   if (Zubo?.getGoogleToken) return Zubo.getGoogleToken();
@@ -80,7 +86,7 @@ export default async function (input: Record<string, unknown>): Promise<string>
       case "send": {
         if (!to) return JSON.stringify({ error: "to is required" });
         if (!subject) return JSON.stringify({ error: "subject is required" });
-        const raw = Buffer.from(`To: ${to}\r\nSubject: ${subject}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body || ""}`).toString("base64url");
+        const raw = Buffer.from(`To: ${to}\r\nSubject: ${mimeEncode(subject)}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body || ""}`).toString("base64url");
         const res = await fetch(`${API}/messages/send`, {
           method: "POST", headers,
           body: JSON.stringify({ raw }),
@@ -106,7 +112,7 @@ export default async function (input: Record<string, unknown>): Promise<string>
         const replyTo = getHeader("From");
         const subj = getHeader("Subject").startsWith("Re:") ? getHeader("Subject") : `Re: ${getHeader("Subject")}`;
         const msgId = getHeader("Message-ID");
-        const raw = Buffer.from(`To: ${replyTo}\r\nSubject: ${subj}\r\nIn-Reply-To: ${msgId}\r\nReferences: ${msgId}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body}`).toString("base64url");
+        const raw = Buffer.from(`To: ${replyTo}\r\nSubject: ${mimeEncode(subj)}\r\nIn-Reply-To: ${msgId}\r\nReferences: ${msgId}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body}`).toString("base64url");
         const res = await fetch(`${API}/messages/send`, {
           method: "POST", headers,
           body: JSON.stringify({ raw, threadId: origData.threadId }),

package/src/tools/builtin-skills/http-request/handler.ts CHANGED Viewed

@@ -37,11 +37,17 @@ function validateUrl(raw: string): void {
 export default async function (input: Record<string, unknown>): Promise<string> {
   const url = input.url as string;
   const method = ((input.method as string) || "GET").toUpperCase();
-  const headers = (input.headers as Record<string, string>) || {};
+  const rawHeaders = (input.headers as Record<string, string>) || {};
   const body = input.body as string | undefined;
   validateUrl(url);
+  // Strip non-ASCII characters from header values (HTTP/1.1 requires ASCII)
+  const headers: Record<string, string> = {};
+  for (const [key, value] of Object.entries(rawHeaders)) {
+    headers[key] = String(value).replace(/[^\x20-\x7E]/g, "");
+  }
   const opts: RequestInit = {
     method,
     headers: {