Telegram Messaging

Send messages to Telegram using the Bot API. The plugin provides both manual (/telegram ) and automatic session notifications.

Quick Start

/telegram Your message here

Credentials

Set two environment variables (add to ~/.bashrc or ~/.zshrc for persistence):

export TELEGRAM_BOT_TOKEN="your-bot-token" # from @BotFather export TELEGRAM_CHAT_ID="your-chat-id" # from @userinfobot

Configuration

Create .claude/telegram.local.md (project) or ~/.claude/telegram.local.md (global):

enabled: true session_threshold_minutes: 10

Your custom notification message here

See examples/telegram.local.md.example for a working config template.

Plugin Behavior

Opt-in design: The plugin only validates credentials and sends automatic notifications when .claude/telegram.local.md exists with enabled: true .

Manual command: The /telegram command works anytime if credentials are set, regardless of the config file.

Resources

• Full documentation: README.md (at plugins/telegram/README.md )

• Configuration details: references/configuration.md

• Troubleshooting: references/troubleshooting.md