beecork open source

Give Claude Code a phone number,
a memory, and an alarm clock

Beecork makes Claude Code always-on. Reachable from Telegram and WhatsApp, schedulable via cron, with persistent memory and intelligent routing. Claude Code is the agent — Beecork is the smart pipe.

Quick install
$ npm install -g beecork $ beecork setup $ beecork start

Or one-liner: curl -fsSL https://beecork.com/install.sh | bash

Features

Everything Claude Code needs to run unsupervised

🧠

Intelligent routing

Send a plain message — Beecork figures out which project it belongs to using its own memory and an AI routing layer. No commands needed.

🎯

Goal tracking

Beecork evaluates if Claude actually finished the task. If not, it sends follow-ups automatically until the job is done. Up to 5 retries.

💬

Telegram & WhatsApp

Message Claude Code from your phone. Live streaming output, emoji reactions, typing indicators. Full bidirectional conversation.

⏰

Cron jobs

Three schedule types: one-time, interval, or cron expression. Claude can create its own schedules. Missed fires detected and retried.

📚

Persistent memory

The pipe owns its own memory — projects, preferences, decisions. Auto-extracts knowledge from every session. Injects context into future conversations.

📄

Virtual tabs

Each project gets its own session with separate history and working directory. Sessions persist across restarts via --resume.

🛡

Safety & recovery

3-tier loop detection (warn → notify → kill). Context window compaction at 90%. Auto-resume crashed sessions. Circuit breakers.

⚙

10 MCP tools

Claude Code gets tools to remember facts, recall memories, schedule crons, create tabs, notify you mid-task, and check system status.

🔍

Project discovery

Scans your filesystem for git repos during setup. Learns about new projects from conversations. Builds a map of your codebase.

📦

Zero cloud dependency

SQLite database, local storage, no accounts, no SaaS. Works on Mac and Linux. Uses your Claude Pro/Max subscription — zero API cost for tasks.

How it works

Three commands to always-on

  1. npm install -g beecork

    Install the CLI globally. Requires Node.js 18+ and Claude Code CLI with a Pro or Max subscription.

  2. beecork setup

    Interactive wizard: connect Telegram bot, set Claude path, optionally add Anthropic API key for intelligent routing, scan filesystem for projects, install as background service.

  3. beecork start

    Launches the daemon via launchd (Mac) or systemd (Linux). Persists across reboots. Auto-recovers crashed sessions.

You → Telegram/WhatsApp → Pipe Brain (routes & tracks goals) → Claude Code → your codebase
Cron → Pipe Brain → Claude Code → your codebase

Pipe Brain uses: memory (SQLite) • project registry • routing history • Anthropic API (Haiku/Sonnet)
CLI

Full command reference

beecork setup        First-time configuration wizard
beecork start        Start the daemon
beecork stop         Stop the daemon
beecork status       Show tabs, cron jobs, daemon info
beecork tabs         List all virtual tabs
beecork logs [tab]   Tail daemon or tab logs
beecork cron list    List scheduled jobs
beecork cron delete  Remove a scheduled job
beecork memory list  Show stored memories
beecork send <msg>   Test: send to default tab
beecork update       Update to latest version
Requirements

What you need

Node.js 18+

nodejs.org

Claude Code CLI

Pro or Max subscription. claude.ai/code

Telegram bot

Free via @BotFather (30 seconds)

Optional: Anthropic API key enables intelligent routing and goal tracking via Haiku/Sonnet.