GitHub

Project dossier

Claude Assistant Bridge

A self-hosted AI assistant you control from your phone.

Text a Telegram bot from anywhere. Claude Code executes the task on your machine and replies with the result. A lightweight, open-source OpenClaw alternative for Claude Max subscribers — no Docker, no extra API costs, cross-platform.

📱 → 🤖 → 💻

You send a message on Telegram. CAB forwards it to Claude Code on your computer. Claude does the work. The answer comes back to your phone.

Highlights

  • Conversation memory: Claude remembers context within a session. Send /new to start fresh, or sessions auto-reset after 6 hours of inactivity.
  • Natural language scheduling: Create, edit, and delete recurring tasks in plain English.
  • Intelligent catch-up: Missed tasks while the PC was off are recovered smartly, not blindly re-run.
  • Searchable audit trail: Every run is logged and queryable in plain English — “Did anything fail this week?”
  • Dual deployment: Run Windows and Linux VPS side-by-side — local files on one, 24/7 scheduled tasks on the other.
  • Plugin system: Extend your bot with custom handlers — drop in a Python file and register it via environment variable.
  • No extra API costs: Uses Claude Code CLI, which runs on your existing Claude Max subscription.

💡 Why I built this

OpenClaw is what got me here. I was completely addicted from the first minute I got it running: texting my MoltBot and watching it do real work was genuinely magical. That experience is what made me obsessed with agentic AI, and I owe a lot to that project for showing me what was possible.

But over time the friction added up. It required Docker, was designed Mac-first, and running it with good models was expensive! I spent too much time debugging it and customizing it in ways that ultimately didn't pan out.

CAB is my clean-slate take on the same idea: no Docker, no API costs, and a small codebase.

🔧 Stack

Python (FastAPI) · Claude Code CLI · Telegram Bot API · Cloudflare Tunnel · Caddy · Hetzner VPS