Agent Relay

Discover agents

In the interactive relay shell, run /discover to list the agent adapters Agent Relay can find on the current machine:

text
/discover

A safe, read-only check any time you're unsure what's installed or which version of an agent CLI is on your PATH.

Synopsis

In the relay shell:

text
/discover [flags]

From another terminal, for scripts and CI, agent-relay discover takes the same arguments:

terminal
agent-relay discover [flags]

Options

discover has no command-specific flags. It honors the root --json and --quiet output flags.

Sample output

text
adapter        alias   version       status
────────────── ─────── ───────────── ──────────
claude-code    c       1.7.4         ready
codex          x       0.12.0        ready
gemini-cli     g       —             not installed
opencode       o       —             ready

The alias column is the short name accepted by /use, /run, agent-relay run, and other commands that take an agent name.

Examples

The basic listing is a slash command in the relay shell. The JSON and quiet forms are most useful from a script, where agent-relay discover takes the same flags.

text
/discover

Prints the formatted table above. Returns exit code 0 if at least one adapter is ready.

Exit codes

CodeMeaning
0At least one adapter is ready.
1No supported agents found. Install Claude Code, Codex, Gemini, or OpenCode and rerun.

Related

run

Start in the interactive shell, or run a scriptable task against any ready adapter.

Installation

Install Agent Relay itself before discovering agents.