> ## Documentation Index
> Fetch the complete documentation index at: https://radiusbrowser.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Command reference

> Reference for Radius CLI resources, commands, and structural options.

## App

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius window list [--json]
radius window get <window-id> [--json]
radius window focus <window-id> [--json]
```

## Groups

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
--size <fraction-or-percent>
--keep-anchor-active
```

`tab split` additionally supports:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
--move-between-groups
```

Examples:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius events [--window <window-id>] [--group <group-id>]
```

See [Event streams](/docs/radius-cli/events).

## 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.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius tab list --json
radius events
```

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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius group rename group_research "Web research" --json
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "group_research",
  "workspaceRevision": 93
}
```

The exact fields depend on the command. See
[Errors and exit codes](/docs/radius-cli/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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
window_1
group_group-example
tab_42
```

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