tg-cli

A Telegram bot CLI for managing Claude Code agent sessions — remote notifications, inter-agent communication, cron scheduling, and session orchestration.

tg-cli is a Go-based CLI tool that bridges Telegram with Claude Code, enabling remote agent management through a Telegram bot interface.

Core Features

  • Session Management — Create, monitor, and control multiple Claude Code sessions from Telegram
  • Mailbox System — Inter-agent communication via structured messages with subject lines and threading
  • Cron Scheduler — Schedule recurring or one-time tasks with inject/print modes for agent automation
  • Event Streaming — Real-time notifications for agent events (tool calls, completions, errors)
  • File Sharing — Send and receive files between local filesystem and Telegram

Architecture

tg-cli runs as a systemd service, acting as a bridge between Telegram Bot API and local Claude Code instances running in tmux sessions. It supports multiple concurrent agent sessions, each with isolated context and communication channels.