Telegram

Telegram is optional and belongs to the Maestro gateway. It is not required by projects or by the Dashboard.

Setup

Create a bot with BotFather, put its token in .env.local, and restrict it to your own Telegram ID:

TELEGRAM_BOT_TOKEN=your-token
TELEGRAM_ALLOWED_USER_ID=your-telegram-user-id

Run npm run telegram:connect in a source checkout, or configure the connection from the available Dashboard flow. A missing token keeps Telegram inactive; it should not prevent the packaged app from opening its Dashboard.

Commands

/start       /help
/status      /status @project
/projects    /project_add <key> <path>
/task @key <request>
/queue       /queue @key
/graphs      /graph_cancel <id>
/cancel <task-id>
/doctor      /doctor @key
/cost        /update
/improvements
/improve_approve <id>
/improve_reject <id>

Plain text is stored as feedback. Commands and notifications are written to the local event log. Unauthorized users receive no operational data when TELEGRAM_ALLOWED_USER_ID is set.

Notifications never include tokens, local worktree paths or private Telegram identifiers.