Skip to main content
Your API key never leaves your machine. RemoteAgent.CHAT is a pure relay — it routes messages between Telegram and your local agent without storing or inspecting your credentials, prompts, or code.
1

Install the agent

Download and install the RemoteAgent.CHAT binary with a single command:
Verify the installation:
The binary is self-contained — no Node.js or runtime required. Runs on Linux, macOS, and Windows (WSL recommended on Windows).
2

Install your runner (if needed)

RemoteAgent.CHAT supports multiple AI runners. The default is claude-code — requires the claude CLI installed and authenticated. Other runners require their own binary installed first.See Runners for details on each option.
3

Get your pairing code from the dashboard

Log in to remoteagent.chat with the Telegram widget.Once in the dashboard, click Pair new agent, enter a project name, and confirm. The dashboard will display a pairing code — a short string like XK9-4TZ.
The pairing code expires in 10 minutes and can only be used once. Keep the dashboard tab open while you complete the next step.
4

Run the init wizard

Navigate to the project directory you want to control, then run:
The interactive wizard will ask you:
  • Runner — which AI engine to use. Press Enter to accept the default (claude-code), or type a runner name.
  • API key — only required for runners that need one. Stored locally in ~/.remoteagent/agents/{agentId}.json, never transmitted.
  • Pairing code — paste the code you got from the dashboard in the previous step.
Once the code is accepted, the agent is paired and starts automatically.
5

Send your first command

Open Telegram, find the RemoteAgent.CHAT bot (a link is shown after pairing), and send a message:
The agent will start running immediately. Output streams back to Telegram in real time as the AI produces it. Long responses are split into multiple messages automatically.Try a more targeted task:
To abort a running task at any time, send:

​
Updating

This updates the binary in-place and automatically restarts any running agents.

​
What’s next

  • Learn about all available runners and how to switch between them.
  • Set up multiple projects to control different codebases from the same bot.
  • Explore the dashboard to view session history and manage your account.