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

# Radius CLI

> Control live Radius windows, groups, tabs, and splits from the shell.

The Radius CLI is a Unix command-line interface for controlling the live browser
structure of a running Radius app.

If Radius is installed, you already have everything required. The CLI is available
automatically in Radius terminals, and Radius can install the same command for any
other terminal with one click.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius group rename "$RADIUS_GROUP_ID" "Development"
app="$(radius tab open http://localhost:3000 --right-of "$RADIUS_TAB_ID")"
radius tab focus "$app"
```

Commands are imperative and literal. Opening a tab always creates a new tab.
After a command finishes, the user can navigate, resize, move, or close
anything normally.

<CardGroup cols={2}>
  <Card title="Set up the CLI" icon="terminal" href="/docs/installation">
    Use it immediately in Radius or add it to your regular terminal.
  </Card>

  <Card title="Run the quickstart" icon="bolt" href="/docs/quickstart">
    Open real tabs in one group and split only the local server.
  </Card>

  <Card title="Create startup scripts" icon="code" href="/docs/guides/startup-scripts">
    Use the group and terminal IDs supplied by Radius.
  </Card>

  <Card title="Configure a project" icon="settings" href="/docs/project-settings/overview">
    Share environment, Git, worktree, and command behavior with your repository.
  </Card>

  <Card title="Browse the cookbook" icon="utensils" href="/docs/cookbook">
    Copy recipes for development workspaces and tab automation.
  </Card>

  <Card title="Command reference" icon="book" href="/docs/reference/commands">
    See every available app, window, group, tab, and event command.
  </Card>
</CardGroup>

## What it controls

* Browser windows
* Existing tab groups
* Tabs, URLs, focus, and closing
* Horizontal and vertical tab splits

## What it does not control

The CLI does not inspect page content or click page elements. Group creation
currently happens in Radius; the CLI operates on groups after they exist.

The app-bundled CLI does not require a separate runtime or package manager and
updates with Radius. A standalone npm installation is also available and has its
own version and release cadence. Compatibility is negotiated through the Radius
automation protocol rather than requiring matching app and CLI versions.

## Command shape

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius <resource> <verb> [subject] [options]
```

The resources are `app`, `window`, `group`, `tab`, and `events`.
Query commands have human-readable output by default and support `--json`.

For event streams, multiple instances, and concurrency controls, see
[Advanced automation](/docs/advanced/json-and-concurrency).

To configure the repository environment and the commands that invoke the CLI,
see [Project settings](/docs/project-settings/overview).