nexus-telegram
The Telegram command gateway. It turns high-level chat commands into Nexus goals/tasks and relays status and alerts back.
Responsibilities
- Receive high-level commands
- Authenticate allowed users (allowlist)
- Create Nexus goals
- Reply with status
- Send approval notifications
- Send failure alerts
Stack
| Library | Use |
|---|---|
teloxide | Telegram bot framework |
tokio | async runtime |
serde | serialization |
tracing | logs / spans |
reqwest | calls into Nexus Core |
axum (optional) | webhook receiver |
teloxide lets you focus on bot business logic rather than Telegram API
plumbing.
Commands
/nexus create goal Build auth system
/nexus status
/nexus approve task_123
/nexus pause project nexus
/nexus run sprint current
Example interaction:
/nexus create goal "Build authentication system for my app"
→ Goal created.
→ Drafted 8 tasks.
→ Waiting for approval in Nexus UI.
Security
Only allowlisted Telegram user IDs may issue commands; the allowlist and an
audit of inbound commands live in the telegram_commands collection. Sensitive
actions still route through the approvals flow in the UI.