Bot commands

Send commands to the Teleportus bot in Telegram. Each command is answered immediately; no form or login required.

/start

/start

The bot sends a welcome message with a short description and a reminder to use /remote to open your desktop.

/remote

/remote

The bot replies with an Open Desktop inline button. Tap it to open the Mini App and connect to your running daemon. The button URL encodes your SESSION_TOKEN so the Mini App knows which session to join.

If the daemon is offline when you open the Mini App, you'll see a "waiting for daemon…" screen. Start the daemon on your Mac and the Mini App will connect within a few seconds.

/screenshot

/screenshot

The bot sends a single JPEG screenshot of your current screen as a Telegram photo message — useful for a quick glance without opening the full stream.

Natural-language AI tasks

Any message that is not a slash command is forwarded to the local AI runner on your Mac. Describe what you want done in plain language:

open Terminal and run npm test
go to the Safari window and click the Login button
create a new file called notes.txt on the Desktop

The AI sees your current screen and can perform multi-step actions using mouse, keyboard, and shell commands. Results appear as follow-up messages from the bot.

Share commands

See Sharing for commands that generate view-only access links for other people.

Daemon not running?

If the daemon is offline, the Mini App shows a connection error and AI tasks time out. Start the daemon on your Mac and try again:

npx remote-claude-daemon@latest