Command reference

App

radius --version
radius version [--json]
radius doctor [--json]
radius app status [--json]

radius --version reports the CLI package version without connecting to Radius. The remaining commands report the connected Radius version, compatibility, application status, and browser windows.

Windows

radius window list [--json]
radius window get <window-id> [--json]
radius window focus <window-id> [--json]

Groups

radius group list [--window <window-id>] [--json]
radius group get <group-id> [--json]
radius group show <group-id> [--json]
radius group create <title> --tab <tab-id> [--json]
radius group rename <group-id> <title> [--json]

group show prints the group’s tabs and split layout. group create creates a group containing the requested tab. If the tab is part of a split, the whole split is grouped as one collection.

Tabs

radius tab list [--group <group-id>] [--window <window-id>] [--json]
radius tab get <tab-id> [--json]
radius tab open <url> [--group <group-id>] [--project-path <path>]
radius tab open <url> [--project-path <path>] (--left-of|--right-of|--above|--below) <tab-id>
radius tab navigate <tab-id> <url>
radius tab focus <tab-id>
radius tab close <tab-id>...
radius tab split <anchor-tab-id> (--left|--right|--above|--below) <tab-id>
radius tab separate <tab-id>
radius tab wait <tab-id> [--load] [--url <substring>]

Adjacent opens and split commands support:

--size <fraction-or-percent>
--keep-anchor-active

tab split additionally supports:

--move-between-groups

Examples:

radius tab navigate tab_12 "https://example.com"
radius tab focus tab_12
radius tab close tab_12 tab_18
radius tab wait tab_18 --load --timeout-ms 30000
radius tab wait tab_18 --url "/dashboard"

Events

radius events [--window <window-id>] [--group <group-id>]

See Event streams.

Common options

Option	Purpose
`--json`	Print one structured JSON result.
`--window <window-id>`	Address a specific browser window.
`--group <group-id>`	Filter by or open in a specific group.
`--project-path <path>`	Set the project or worktree for a new chat, diff viewer, or terminal. Relative paths resolve from the CLI working directory.
`--timeout-ms <milliseconds>`	Set the command timeout.
`--if-workspace-revision <revision>`	Apply a mutation only if the workspace has not changed.
`--instance <instance-id>`	Address one Radius instance when multiple instances are running.
`--launch`	On macOS, launch Radius if it is not running.

Machine-readable output

Add --json when a script or agent needs one structured result. radius events always streams compact JSON Lines because it produces multiple results over time.

radius tab list --json
radius events

Successful mutations identify the changed resource and the resulting workspace revision:

radius group rename group_research "Web research" --json

{
  "id": "group_research",
  "workspaceRevision": 93
}

The exact fields depend on the command. See Errors and exit codes for failure objects and process exit statuses.

Revision guards

Mutation results include a workspaceRevision. Pass that value back with --if-workspace-revision when a command must apply to the same workspace state that your program inspected:

radius tab focus tab_14 --if-workspace-revision 92 --json

If another command changed the workspace first, Radius returns REVISION_CONFLICT without applying the mutation. Revision guards are optional, and ordinary shell scripts generally do not need them.

IDs

Commands address live Radius resources with IDs:

window_1
group_group-example
tab_42

Tab IDs remain valid while the tab is open. Group IDs identify the group shown in Radius.

Get started

Agents

Radius CLI

Project settings

Cookbook

Changelog

Command reference

App

Windows

Groups

Tabs

Events

Common options

Machine-readable output

Revision guards

IDs

​App

​Windows

​Groups

​Tabs

​Events

​Common options

​Machine-readable output

​Revision guards

​IDs

App

Windows

Groups

Tabs

Events

Common options

Machine-readable output

Revision guards

IDs