Install

Prerequisites

Install these before running the installer:

Claude Code CLI

npm install -g @anthropic-ai/claude-code
claude  # authenticate

Requires an active Claude subscription. Right Agent calls claude -p directly — no API key needed.

Telegram bot token

1. Open @BotFather in Telegram.
2. Send /newbot, follow the prompts.
3. Save the bot token. The installer’s wizard will ask for it.

cloudflared

A Cloudflare account plus the cloudflared CLI, authenticated. The installer creates the named tunnel for you.

# macOS
brew install cloudflare/cloudflare/cloudflared

# Linux
# https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/

cloudflared tunnel login   # authenticate against your Cloudflare account

If you don’t have a Cloudflare account yet, sign up at https://dash.cloudflare.com/sign-up (free tier is sufficient).

Quick Install

One command installs right, process-compose, and NVIDIA OpenShell:

curl -LsSf https://raw.githubusercontent.com/onsails/right-agent/master/install.sh | sh

The installer then runs the interactive right init wizard (asks for the Telegram bot token, sandbox mode, network policy) and right doctor to verify the setup.

Supported platforms: linux x86_64, linux aarch64, darwin aarch64 (Apple Silicon).

Build from Source

For platforms without a prebuilt binary, or when you want to run from a checkout:

git clone https://github.com/onsails/right-agent.git
cd right-agent
cargo install --path crates/right
right init
right doctor

This path requires a Rust toolchain (edition 2024).

After install

right installs to ~/.local/bin. The installer adds that directory to your shell profile; open a new shell (or source your profile) so right is found, then:

right up

right up launches your agents via process-compose. Message your Telegram bot from your account — the agent replies.

Re-run right doctor whenever something seems off. It checks dependencies, agent configuration, sandbox connectivity, MCP status, and tunnel health.