What problem does it solve?
MateCode provides a self-contained Telegram bridge to manage Claude Code by starting, stopping, and monitoring the service, enabling remote control of the code execution environment.
Core Features & Use Cases
- Lifecycle control: Start, stop, and restart the bridge to manage Claude Code remotely.
- Status & logs: Check current status and view logs for quick troubleshooting.
- Configuration & hooks: Set Telegram bot token and Claude stop hook for automated workflows.
- Self-contained tooling: All necessary scripts and configuration live in a single unit with a manifest.
Quick Start
Install dependencies:
macOS: brew install tmux
Ubuntu/Debian: sudo apt-get install tmux
-
Set the Telegram Bot Token:
export TELEGRAM_BOT_TOKEN="your_token_here"
Add to shell startup files:
echo 'export TELEGRAM_BOT_TOKEN="your_token_here"' >> ~/.zshrc
-
Start the service:
./matecode.sh start