The local agent

rc-agent runs on your own machine: it holds the profiles, starts and supervises the CLI servers, and connects out to the hub. Nothing ever connects to your machine.

rcctl is the optional command-line client for the hub; the agent alone is enough to get started.

All downloads

Every release ships both binaries for six platforms. They are static, single-file programs: there is no installer. Each release also publishes a SHA256SUMS file to verify them.

Setting it up

From an empty machine to an agent that comes back by itself after a reboot.

  1. Install Claude Code

    The agent starts sessions of an agent CLI; today that CLI is Claude Code, and it has to be installed and on your PATH.

  2. Log in once per profile

    A profile is one CLI identity: its own configuration home, its own login, its own working directories. For each profile, log in once by hand. The agent never sees the credentials.

  3. Download the binary

    Pick your platform above, verify the checksum, then make it executable and put it somewhere stable on your PATH.

  4. Run it

    It prints the address of its local panel, which binds to the loopback interface only and never renders a secret value.

  5. Pair the machine

    Open the Pairing tab, enter the service URL and approve the code from a signed-in device: the mobile app, the web panel, or rcctl pair approve.

  6. Register profiles

    Add one profile per CLI identity, with its home, its base directory for new sessions and an allowlist of extra working directories.

  7. Install it as a service

    So the agent starts at login and comes back after a crash: a systemd user unit on Linux, a launchd agent on macOS, a service on Windows.

The second runner: Codex CLI

A machine can also run OpenAI's Codex CLI, and its sessions are picked up in the ChatGPT app instead of the Claude app. rc-agent runs one Codex daemon per profile.

Back to the home page