Telegram Command Reference

All commands available through the NexusSuiteBot on Telegram.

General Commands

Command	Description
/start	Begin interaction with the bot and start pairing
/status	Check connection status, agent state, and active model
/help	Show all available commands

Agent Commands

Command	Description
/run <task>	Execute a one-shot agent task
/chat <message>	Send a message to the agent in conversation mode
/stop	Stop the currently running agent task

Examples

/run Create a unit test for src/auth.ts
/chat What does the handleLogin function do?
/run Fix the TypeScript errors in src/utils.ts

TIP

Text messages sent without a command prefix are treated as /chat messages. You can just type naturally.

Session Commands

Command	Description
/pair	Start a new pairing flow (generates a new pairing code)
/unpair	Disconnect the current session
/sessions	List all active sessions across devices

File Commands

Command	Description
/ls [path]	List files in the workspace (or a subdirectory)
/cat <path>	View the contents of a file

Examples

/ls src/
/cat src/auth.ts

Notes

• File attachments sent to the bot are forwarded to the agent's workspace
• Long responses are automatically split across multiple Telegram messages
• Inline buttons appear when the agent needs tool approval (Allow / Deny)
• Code blocks in responses are formatted with Telegram's monospace formatting
• All commands respect the tool allowlist — restricted tools return an error message