> ## 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 rename <group-id> <title> [--json]
```

`group show` prints the group's tabs and split layout.

## 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>]
radius tab open <url> (--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>] [--follow] [--jsonl]
```

See [Event streams](/docs/advanced/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.        |
| `--timeout-ms <milliseconds>` | Set the command timeout.                      |
| `--launch`                    | On macOS, launch Radius if it is not running. |

Advanced options such as `--instance`, `--jsonl`, and
`--if-workspace-revision` are covered under
[Advanced automation](/docs/advanced/json-and-concurrency).

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