Skip to main content

Telegram

The Telegram gateway (nexus-telegram, built on teloxide) turns high-level chat commands into Nexus goals/tasks and relays status and alerts.

Commands​

/nexus create goal Build auth system
/nexus status
/nexus approve task_123
/nexus pause project nexus
/nexus run sprint current

Example​

/nexus create goal "Build authentication system for my app"

→ Goal created.
→ Drafted 8 tasks.
→ Waiting for approval in Nexus UI.

Then in the UI: approve the plan → create Taiga user stories → assign planner/implementer/tester agents → run Kubernetes jobs.

Security​

  • Only allowlisted Telegram user IDs may issue commands (TELEGRAM_ALLOWED_USERS is set in prod). An empty list denies everyone — fail-closed since nexus-platform 445e107, deployed 2026-09-05 (audit C7 closed).
  • The allowlist and an audit of inbound commands live in the telegram_commands collection.
  • Sensitive actions still route through the approvals queue — the gateway cannot bypass permission gates.