# yottoCode

> A native macOS app that bridges Claude Code and Telegram, enabling full agent controls with voice input/output, permission keyboards, and session management.

yottoCode is a native macOS application that connects Claude Code to Telegram, built on the official Anthropic Agent SDK. It transforms Telegram into a powerful interface for controlling AI coding agents, allowing developers to manage their development environment from any device where Telegram runs. Unlike cloud-based coding tools or AI chatbots, yottoCode provides full desktop access to your actual development environment.

- **Full Agent Control** - Access every Claude Code control directly in Telegram with inline keyboards for permissions, session resume, model switching between Haiku/Sonnet/Opus, MCP server management, and live cost tracking per message and session.

- **Interactive Permissions** - Choose between interactive approval mode or full auto-allow with two modes and one-tap switching. Approve or deny AI actions through intuitive Telegram inline keyboards.

- **Voice In & Out** - Send voice notes transcribed locally by Whisper, and receive voice replies from Claude. Both speech-to-text and text-to-speech run entirely on your Mac, ensuring your voice data never leaves your machine.

- **Real-time Streaming** - Watch Claude think in real-time with progressive message updates, tool progress indicators, and smart rate-limited chunking for a responsive experience.

- **Session Resume** - Resume past sessions with full history persisted to disk, maintaining context across conversations without losing progress.

- **MCP Server Integration** - Connect, disconnect, and toggle Model Context Protocol servers without restarting, enabling integrations with WhatsApp, Gmail, Google Docs, Slack, Notion, Linear, and more.

- **Smart Context** - Reply to any message to give Claude context. Claude reacts with emoji to acknowledge messages, creating natural Telegram-native conversations.

- **Files & Screenshots** - Claude sends files directly to your Telegram chat. Request screenshots of your Mac screen to review output without touching your desk.

To get started, create a bot via @BotFather on Telegram, launch the yottoCode app on your Mac, enter your bot token, select a project directory, and choose your model. Each bot instance handles one project directory, with a multi-bot launcher included for managing multiple projects simultaneously. The app works with your existing Claude Max, Team, or Enterprise subscription with no API keys required, though API key mode is also available with live cost tracking.

## Features
- Full Claude Code control via Telegram
- Interactive permission keyboards
- Voice input via Whisper transcription
- Voice output with text-to-speech
- Real-time streaming responses
- Session resume with full history
- Model switching (Haiku/Sonnet/Opus)
- MCP server integration
- Live cost tracking per message and session
- Smart context via message replies
- File sharing to Telegram
- Screenshot capture
- Multi-bot launcher for multiple projects
- API key mode support
- Rate limiting protection

## Integrations
Telegram, Claude Code, Anthropic Agent SDK, Whisper, WhatsApp MCP, Gmail MCP, Google Docs MCP, Slack MCP, Notion MCP, Linear MCP, Model Context Protocol

## Platforms
MACOS, WEB, API

## Pricing
Freemium — Free tier available with paid upgrades

## Version
1.0.0

## Links
- Website: https://yottocode.com
- Documentation: https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview
- EveryDev.ai: https://www.everydev.ai/tools/yottocode