Remote Agents

MCP server that lets an AI run commands, manage files, drive git and orchestrate a fleet of remote machines over an encrypted relay.

What you can do

• Run shell commands and read, write or list files on the local host or a chosen remote agent
• Perform git status, pull, commit and push on hosts
• Run the same exec, read, write, git or search operation across the whole fleet by tag or OS family, plus distributed map/reduce
• Schedule cron-style tasks and dispatch autonomous AI tasks that run with the host's own credentials
• Search and browse each host's local AI-chat history, including fleet-wide ranked snippet search
• Find, stat, send and sync files and folders host to host, and open Cloudflare quick tunnels to a host's local port

When to use it

Useful when one assistant should operate several machines at once: deploying or inspecting hosts, running the same command everywhere, moving files between machines, or recalling past AI-chat decisions across a fleet. Overkill for a single local machine.

Requirements

A local install of the remote-agents binary (npm package remote-agents, or a prebuilt release binary) run in mcp mode over stdio. Needs a relay URL, a room name and a room token, supplied as CLI flags or REMOTE_AGENTS_* environment variables; the relay defaults to a public one. Outbound network access to the relay is required.