name: telegram-bot-management description: Telegram bot production management, monitoring, and troubleshooting. Use when user mentions telegram bot, claude-orchestrator, bot status, bot restart, or bot monitoring.

Telegram Bot Management

Overview

Multi-workspace Telegram bot workflow orchestration with full supervision (launchd + watchexec). Manages the claude-orchestrator Telegram bot for headless Claude Code interactions.

When to Use This Skill

Check bot status, restart, or troubleshoot issues
Monitor bot health and resource usage
View bot logs and debug problems
Manage bot lifecycle (start/stop/restart)

Production Mode

As of v5.8.0, production mode is the only operational mode.

Bot Management Commands

Check Status

bot-service.sh status
# Or use alias
bot status

Shows:

launchd supervision status
watchexec process (PID, uptime, memory)
Bot process (PID, uptime, memory)
Full process tree
Recent log activity

View Logs

bot-service.sh logs
# Or use alias
bot logs

Tails all logs:

Launchd logs (supervision layer)
Bot logs (application layer)

Restart Bot

bot-service.sh restart
# Or use alias
bot restart

Rarely needed due to automatic code reload via watchexec.

Stop Bot

bot-service.sh stop
# Or use alias
bot stop

Reference Documentation

For detailed information, see:

Operational Commands - Status, restart, logs, monitoring commands
Troubleshooting - Common issues and diagnostic steps

telegram-bot-management