Remote Access via Telegram

Control NexusCore remotely through a Telegram bot with end-to-end encryption. Run agent tasks, check status, and interact with your workspace from anywhere using your phone.

Overview

The Telegram integration creates an encrypted bridge between the Telegram messaging app and your local NexusCore instance. Commands are relayed through a WebSocket connection to your machine, and responses are sent back to Telegram.

Your Phone (Telegram) ↔ NexusAPI Relay Server ↔ NexusIDE/CLI (Your Machine)

All messages are end-to-end encrypted — the relay server sees only ciphertext.

Prerequisites

• NexusCore CLI or NexusIDE installed and running on your machine
• A Telegram account
• A Nexus Suite account (any tier)

Quick Setup

From NexusIDE

1. Click Remote Access in the NexusIDE title bar
2. A QR code and pairing code appear
3. Scan the QR code with your phone (opens the Telegram bot) or go to @NexusSuiteBot
4. Enter the 6-character pairing code in Telegram
5. You're connected — start sending commands

From NexusCore CLI

nexus-cli telegram pair

Telegram Remote Access

  Open this link on your phone:
  https://t.me/NexusSuiteBot?start=ABC123

  Or enter this code in the bot: ABC123

  Waiting for pairing...
  ✓ Paired successfully! You can now send commands via Telegram.

How It Works

1. NexusIDE (or CLI) opens a WebSocket connection to the NexusAPI relay server
2. During pairing, an X25519 key exchange establishes encryption keys
3. The Telegram bot receives your messages and forwards them (encrypted) through the relay
4. NexusCore on your machine decrypts the message, processes it, and sends the response back
5. The response is encrypted, relayed, and delivered to your Telegram chat

Session Lifetime

Each pairing creates a session token that expires after 24 hours. After expiration, you'll need to re-pair.

Sections

• Security — Encryption details and access controls
• Command Reference — All available Telegram commands
• Troubleshooting — Common issues and fixes