Control Claude Code from Telegram. Voice-first mobile coding.

Website · Download

Vibegram is a macOS menu bar app that bridges Telegram to Claude Code CLI. Send voice messages or text from your phone, and Claude Code executes on your machine.

Use cases:

• Voice-code from anywhere (Telegram transcribes for you)
• Quick fixes without opening your laptop
• Mobile pair programming with Claude
• Use Claude Code while AFK - meetings, commutes, couches

1. Claude Code CLI - Install from claude.ai/claude-code
2. Telegram Bot Token - Create a bot via @BotFather
3. Your Telegram User ID - Get it from @userinfobot

1. Download the latest .dmg from Releases
2. Drag Vibegram.app to Applications
3. Open the app (it will be blocked by Gatekeeper)
4. Go to System Preferences → Privacy & Security
5. Scroll to Security and click "Open Anyway"
6. Configure your bot token and user ID in Settings

# Clone
git clone https://github.com/Studio-Sunnyfield/vibegram.git
cd vibegram

# Install dependencies
npm install
cd app && npm install && cd ..

# Build
npm run build

# App is at app/dist/mac-universal/Vibegram.app

• Images - Send screenshots for Claude to analyze
• Session persistence - Resume where you left off
• Live status - See what Claude is doing in real-time
• Auto-update - Checks for new versions on startup

The menu bar icon shows:

• Filled - Bot is running
• Outline - Bot is stopped

In chat:

• 💭 Thinking... - Processing your request
• 🔧 Running command - Executing a tool
• 💭 Responding... - Generating response
• ✅ Done - Task complete

When Claude Code runs via Vibegram, it sets:

VIBEGRAM_SOURCE=telegram

Use this in Claude Code hooks to customize behavior for Telegram messages.

• Single user only - Only your Telegram user ID can interact with the bot
• Local execution - Claude Code runs on your machine, not in the cloud
• No data collection - Your conversations stay between you and Claude

App won't open:

1. Try to open the app
2. Go to System Preferences → Privacy & Security
3. Click "Open Anyway" under Security

Bot won't start:

• Verify your bot token with @BotFather
• Check your user ID with @userinfobot
• Ensure Claude Code CLI is installed: claude --version

Commands not working:

• Make sure the bot is running (filled icon in menu bar)
• Check the project directory exists

v1.1 - CLI Mode

• Standalone CLI (no Electron dependency)
• npx vibegram or vibegram serve
• Deploy on any server/VM, run headless
• Config via env vars or ~/.vibegram.json

v1.2 - Multi-Agent Support

• Abstract the "coding agent" interface
• Support opencode, aider, other CLIs
• --agent claude|opencode|aider

v1.3 - Multi-Messenger

• Abstract the "messenger" interface
• Discord, Slack, WhatsApp, Signal
• Same bot logic, different transports

v2.0 - Cross Platform

• Linux support (CLI mode)
• Windows support
• System tray for non-macOS

MIT - see LICENSE

Made by Studio Sunnyfield