CLI

This page lists every command radian accepts. The running binary is the source of truth: radian <cmd> --help prints the same facts. rad is an alias of radian.

radian: the full-screen interface#

Run radian with no subcommand to open the full-screen interface. Run it only in a real terminal: it takes over the screen. --model is required unless the configuration file sets model.model.

TUI options#

Model options#

Session options#

MCP options#

Permission options#

Example:

radian --provider openai-compatible --model gpt-5 --profile workspace -w "$PWD" --session-id demo

radian exec: the headless command#

radian exec runs one turn or a line session without a terminal. With -p it prints only the model text to stdout and exits; status goes to stderr. Without -p it runs a line prompt loop. The print-and-exit modes (--list, --export, --search, --fork) need no model and read no key.

Examples:

radian exec --provider openai-compatible --model gpt-5 -p "summarize Cargo.toml"
radian exec --resume demo -p "now read docs/"
radian exec --list
radian exec --export demo --format json --out demo.json
radian exec --search "bubblewrap"
radian exec --fork demo --at 12

radian login and radian logout#

radian login [PROVIDER] stores an API key in ~/.radian/credentials/auth.json. PROVIDER is a built-in id (opencode-go, anthropic, openai, openai-compatible), chatgpt (browser OAuth), chatgpt-device (device code), or custom, which names a new endpoint: name, protocol, base URL, and key. An unknown provider is refused. A bare radian login shows the numbered provider list. The key never echoes. A verification request (GET <base>/models) runs before the save. A failure shows and still offers to save. Without a terminal the command refuses and points at auth.json instead.

radian login
radian login anthropic

radian logout <provider> removes one stored credential. It asks first. Every other entry stays untouched. Exit 0 on removal or on an explicit keep, 2 when the entry is missing or the run has no terminal.

radian logout anthropic

radian memory#

radian memory runs the same grammar as the /memory slash command. Needs no model, no key, no session file, no network. --workspace <DIR> resolves the project against another directory.

--global and --project conflict except where both are absent (the default scope). list, search, show, and project accept --json for machine output. forget, purge, split, and merge ask for confirmation unless --yes is passed. Exit 0 on success, 1 for a conflict or a missing record, 2 for bad use. See memory for scopes, revisions, and confirmation rules.

radian memory add "prefers tabs" --kind preference --key style
radian memory search tabs --json
radian memory list --all

radian trust#

radian trust shows or changes a directory's project trust decision. Needs no model, no key, no session file, no network. --workspace <DIR> picks the directory the decision is about; omitted, the current directory. Only list ignores it: it prints every saved decision.

status, on, off and forget print exactly one line to stdout. A closed output pipe (radian trust status | head) exits 0 with no panic and no error line: the reader going away is a normal stop. Exit 0 on success, 1 when the store cannot be read or written, 2 for bad use. The TUI's /trust runs the same record and prints the same lines; see commands.md.

radian trust status
radian trust on
radian trust list

radian config#

radian config import-pi --from <DIR> drafts a configuration from a Pi agent directory. The draft goes to stdout and the mapping report to stderr. --write saves the draft to the configuration path (--config, else RADIAN_CONFIG, else the default file) and refuses an existing file. Nothing is written without --write. The command reads only the directory you name: never auth.json, never a secret value, never a !command. Exit 0 for a draft, 1 for a missing directory, a malformed file, a refused write, or an invalid draft, 2 without --from.

radian config import-pi --from ~/.pi/agent > draft.toml
radian config import-pi --from ~/.pi/agent --write

radian config import-claude --claude-home <DIR> --project <DIR> drafts a configuration from Claude Code files. At least one of --claude-home and --project is required. Stdout carries the draft: the config, then each skill file and AGENTS.md body under a header line. --write saves every file instead; nothing that exists is ever changed. Exit 0 for a draft, 2 when neither source is given, 1 for other failures. See configuration for the file format and pi-migration for the Pi mapping table.

radian config import-claude --claude-home ~/.claude > draft.toml
radian config import-claude --project "$PWD" --write

radian theme import#

radian theme import <PI-THEME.json> [--name <NAME>] [--force] converts a Pi theme JSON file to a Radian TOML theme under ~/.radian/themes/. The name defaults to the file name field, else the file stem. --force overwrites an existing file. The command prints the written path and one report line per mapped value. Exit 0 on success, 1 for a missing or bad input, or an existing output without --force. See themes for names, fallback, and overrides.

radian theme import night.json --name night

radian footer export#

radian footer export <PRESET> prints one built-in preset TOML: deck, full, pi, or classic. Use it as the [tui.footer] section to start a customization. An unknown preset exits 2 and names the four. See configuration for the footer keys.

radian footer export pi

radian docs#

radian docs prints one line per manual topic with its description. radian docs <topic> prints that page verbatim, the same text the agent reads. The topic is a page stem (commands) or a file name (commands.md). An unknown topic exits 2 and lists the pages on stderr.

radian docs
radian docs cli

radian attach#

radian attach [SESSION_ID] [--follow] [--session-dir <DIR>] views a session read-only. No input reaches the session and nothing is written. A bare radian attach opens the workspace session picker. --follow keeps reading new committed events until q, Esc, or Ctrl-C. Exit 0 for the view, 2 for an unknown id or no terminal, 1 when rendering fails. See sessions for ids, resume, and export.

radian attach demo --follow

radian serve and radian mcp#

Both names are placeholders in this build. Each exits 2 without serving anything.

Exit codes#

Both hosts share these codes. radian exec --list | head and every print-and-exit mode still exit 0 on a broken pipe. A closed output pipe ends any print-and-exit command of either host with exit 0: the reader going away is a normal stop, so the command stops writing quietly, without a panic and without an error line.