`agent-relay discover`

List the agent adapters Agent Relay can find on the current machine. A safe, read-only check — run it any time you're unsure what's installed or which version of an agent CLI is on your PATH.

Synopsis

terminal

agent-relay discover [flags]

Options

Flag	Type	Default	Description
`--paths`	flag	`false`	Print the resolved binary path for each adapter.
`--json`	flag	`false`	Emit one JSON record per adapter instead of the formatted table.
`--missing`	flag	`false`	Also list adapters Agent Relay knows about but didn't find on the machine.
`--no-color`	flag	`false`	Disable ANSI colors.

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

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

Examples

terminal

agent-relay discover

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

Exit codes

Code	Meaning
`0`	At least one adapter is ready.
`1`	No adapters found. Install `claude-code` or `codex` and rerun.

run

Start a session against any ready adapter.

Installation

Install Agent Relay itself before discovering agents.