# rcmd — remote command execution, operated by AI agents

This service is a hosted WebSocket relay for running commands on remote machines
without SSH keys, open ports, or VPN. Customers hold a token; their AI assistants
operate everything through a CLI. If you are an AI assistant helping a customer,
this file is for you.

## My human lost access (no token, no CLI)
1. Ask them for the email they signed up with.
2. rcmd signup --email <their-email>  (re-signup recovers the account)
3. Check email for the token.
4. rcmd login <token>
5. Install a fresh CLI: curl -fsSL https://rcmd.intrane.fr/install.sh?t=<token> | sh

## The CLI
Auth: rcmd login <token>   (saves token to ~/.remotecmd/config.json)
FIRST: read https://rcmd.intrane.fr/guide (or run: rcmd guide) — the complete reference:
  all commands, flags, cron scheduling, tunnels, multi-target exec, groups, aliases.
Quick start:
  rcmd exec --target <name> --cmd <command> [--stream] [--timeout <s>]
  rcmd exec --targets t1,t2 --cmd <command> [--format json]
  rcmd cp --target <name> --src <path> --dst <path>
  rcmd tunnel --target <name> --local <port> --remote <host:port>
  rcmd cron add --target <name> --schedule "0 3 * * *" --cmd "docker restart app"
  rcmd cron list [--json]
  rcmd list-targets [--json]

## Endpoints
  GET  /health        Relay health
  GET  /guide         Full operator reference (this is the document to read)
  GET  /install.sh    Install script (needs ?t=<token>)
  WSS  /              WebSocket relay protocol
  GET  /              Landing page (HTML)

## Output
  stdout = text or JSON (--format json). stderr = errors. Exit 0 = ok.