RemoteAgent.CHAT runs as a background process on your machine, listening for Telegram commands and forwarding them to your AI runner. All configuration is stored locally in ~/.remoteagent/ — nothing is ever sent to the RemoteAgent.CHAT servers except the relay messages.
Commands
remoteagent init
Set up a new agent and pair it with your Telegram bot.
Launches an interactive wizard that asks for:
- Runner — which AI engine to use (see Runners)
- Authentication — API key or OAuth token, depending on the runner
- Pairing code — generated from the dashboard
Flags:
remoteagent start [name] [-f] [-v]
Start an agent. Runs in background by default.
remoteagent stop [name]
Stop a running background agent.
remoteagent logs [name]
Tail the log file of a background agent in real time.
Logs are stored in ~/.remoteagent/agents/{agentId}.log.
remoteagent config
Interactively update settings: API key, preferred language, and per-agent project path or name.
You can also pass flags directly:
remoteagent set-path [name]
Shortcut to update the project directory for an agent without going through the full config menu.
remoteagent remove [name]
Remove an agent: stops it, deletes its local config, and unregisters it from the server.
This action is irreversible. The agent will need to be re-paired from scratch
if you want to use it again.
remoteagent startall
Start (or restart) all configured agents in background. Useful for reboots or after reinstall.
remoteagent reinstall
Download and install the latest version of RemoteAgent.CHAT, then restart all running agents.
remoteagent list
Show all configured agents and their current status (online / offline).
remoteagent help
Show the built-in help message with all available commands.
Configuration files
All config is stored locally. Nothing is transmitted to RemoteAgent.CHAT servers except relay messages.
