██████╗ ██████╗ ██████╗     ██████╗ ███████╗███╗   ███╗ ██████╗ ████████╗███████╗
██╔══██╗██╔══██╗██╔══██╗    ██╔══██╗██╔════╝████╗ ████║██╔═══██╗╚══██╔══╝██╔════╝
██████╔╝██║  ██║██████╔╝    ██████╔╝█████╗  ██╔████╔██║██║   ██║   ██║   █████╗  
██╔══██╗██║  ██║██╔══██╗    ██╔══██╗██╔══╝  ██║╚██╔╝██║██║   ██║   ██║   ██╔══╝  
██████╔╝██████╔╝██████╔╝    ██║  ██║███████╗██║ ╚═╝ ██║╚██████╔╝   ██║   ███████╗
╚═════╝ ╚═════╝ ╚═════╝     ╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝ ╚═════╝    ╚═╝   ╚══════╝
                               O P T I M I Z E D   A G E N T   S K I L L S

🌐 BDB CONNECT (v2.0) - Zero-Trust Tailscale Gateway

The Identity-Aware Proxy & Native Menubar App for remote execution of Antigravity (AGY), Codex, and Claude Desktop over Tailscale.

Work on your powerful stationary workstation directly from your mobile laptop (e.g., on an ICE train) with zero perceived latency, under 5 KB/s bandwidth, and full access to all workstation compute, 152 BDB skills, and the memB vector memory engine.

⚡ Installation & Downloads

1. Download Native Desktop Apps (BDB CONNECT v1.4.0)

Download the standalone installer directly for your operating system:

| Platform | Installer Package | Format | Architecture | | :--- | :--- | :--- | :--- | | Windows | 📥 BDB CONNECT Setup 1.4.0.exe | NSIS Executable | x64 | | macOS | 📥 BDB CONNECT-1.4.0-arm64.dmg | Apple Disk Image | Apple Silicon (M1/M2/M3/M4) | | macOS (Zip) | 📥 BDB CONNECT-1.4.0-arm64-mac.zip | Portable Archive | Apple Silicon |

2. Universal CLI Setup Wizard (One-Click)

Run this single command on either machine to launch the interactive setup wizard:

npx @hybridlabor-api/bdb-os-remote@latest installer

🔄 The 2-Step Connection Workflow

[Step 1: Workstation (Mac/Linux/PC)] ──────▶ Starts Gateway Daemon (:9080 / :8000)
                                                    │ (Tailscale WireGuard Mesh)
[Step 2: Laptop (Client)]            ──────▶ Connects & Injects AGY / Codex / Claude Config

Step 1: Workstation (Server & Autostart Daemon)

1. Run the installer and choose [1] Workstation (Server Mode) to automatically register the background service, or install the native BDB CONNECT Menubar App.
2. Or manage the persistent OS autostart daemon directly via CLI:

   # Install and start as a background daemon (LaunchAgent / Windows Scheduled Task)
   npx @hybridlabor-api/bdb-os-remote@latest service install --port 9080 --workspace "~/dev/bdb-dev"
   
   # Check daemon status
   npx @hybridlabor-api/bdb-os-remote@latest service status
   
   # Uninstall daemon
   npx @hybridlabor-api/bdb-os-remote@latest service uninstall

Step 2: Laptop (Client)

1. Run the installer on your laptop and choose [2] Laptop (Client Mode).
2. Enter your Workstation's Tailscale IP (e.g. 100.123.207.82) and Port (9080).
3. Select your AI Agent Harness (Antigravity (AGY), Codex / OpenCode, or Claude Desktop).
4. Verify the tunnel health:

   npx @hybridlabor-api/bdb-os-remote@latest status --host 100.123.207.82 --port 9080

🛠️ Troubleshooting & FAQ

ECONNREFUSED 100.x.x.x:<port>

• Cause: The Gateway server is not running on the Workstation, or the port numbers do not match.
• Fix: Verify on the Workstation that npx @hybridlabor-api/bdb-os-remote server --port <port> is active and listening.

Windows SSH: Connection refused

• Cause: OpenSSH Server is not installed or the sshd service is stopped on Windows.
• Fix: Run npx @hybridlabor-api/bdb-os-remote@latest installer on Windows. The installer automatically detects missing SSH, prompts for permission, and installs/starts OpenSSH with administrator elevation.

Verify Tailscale Mesh

• Ensure both devices are on the same Tailscale tailnet:

  tailscale status
  tailscale ping 100.123.207.82

✨ Was ist neu in v2.0 (BDB CONNECT)?

• 🎛️ Native Desktop App (Electron): Ein wunderschönes, rahmenloses Popover-Fenster direkt in deiner macOS Statusleiste oder im Windows System-Tray. Steuere den Server-Status mit einem Klick!
• 🌐 Cross-Platform: Voller Support für macOS (.dmg), Windows (.exe), und Linux (.AppImage) via GitHub Actions.
• 🛡️ Zero-Trust Identity-Aware Proxy: Der Server prüft bei jedem Request, ob er von einer verifizierten 100.x.x.x oder fd7a:... Tailscale-IP stammt.
• 🔄 Multi-Agent Support: Nahtlose Integration für Antigravity (AGY), Codex / OpenCode, und Claude Desktop.
• 🚀 Web UI Launcher: Öffne das BDB OS Agent Workspace Web-Dashboard direkt über den neuen Button im Menüleisten-Fenster.

🏗️ Architecture

graph TD
    subgraph Laptop ["💻 Laptop (Client)"]
        UI["BDB CONNECT App"]
        AGY["Antigravity (AGY)"]
        CLAUDE["Claude Desktop"]
        CODEX["Codex"]
        MOCK["BDB Local Compatibility Mock"]
        
        AGY --> MOCK
        CLAUDE --> MOCK
        CODEX --> MOCK
    end

    subgraph Tailscale ["🔒 Tailscale WireGuard Mesh"]
        TS["Zero-Trust (100.x.x.x)"]
    end

    subgraph Workstation ["🖥️ Workstation (Server)"]
        GW["🔌 BDB CONNECT Gateway :8000"]
        MEMB["🧠 memB Vector Memory"]
        FS["📁 Workspace Filesystem"]
        GW --> MEMB
        GW --> FS
    end

    MOCK -->|HTTP/SSE| TS
    TS --> GW

🔒 Security & Requirements

• Tailscale: Both machines must be logged into the same Tailscale network.
• No Open Ports: Zero public port forwardings needed; protected by WireGuard encryption.
• Node.js: Requires Node.js >= 18.0.0 (if using CLI).

📖 Documentation

Detailed technical documentation and architecture decisions are available in .openwiki/architecture.md.

📄 License

MIT © BDB Dev Team