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

# Set up the CLI

> Make the radius command available from any terminal.

If Radius is already installed, the CLI is included in the application. Radius asks
once whether it should install `/usr/local/bin/radius` for external terminals.
You do not need Node.js, a package manager, Homebrew, or a source checkout for
the app-bundled command.

## Use the terminal inside Radius

Open a terminal tab in Radius and run:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius doctor
```

The `radius` command is available automatically in terminals opened by Radius.
Those terminals also receive the current window, group, and tab context, which
makes them the easiest place to write group automation.

## Use your regular terminal

To use the CLI from Terminal, iTerm, Ghostty, or another terminal:

1. Open Radius.
2. Choose **Radius → Install Command Line Tool…** from the macOS menu bar.
3. Open a new terminal window.
4. Run:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius doctor
```

Radius adds the `radius` command to your `PATH` and keeps it updated with the
application.

If another `radius` command is already installed, Radius preserves it. The menu flow
shows which command is active and lets you explicitly replace or repair the
app-owned launcher.

## Install from npm

The standalone macOS package requires Node.js 20 or newer:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npm install --global @sandbox-technologies/radius-cli
```

npm installations update through npm. App-owned launchers update when the Radius
application updates.

## Verify the connection

With Radius running:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius app status
radius window list
```

If Radius is not running, start it from the CLI:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius app status --launch
```

To print the CLI package version without connecting to Radius:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius --version
```

## Repair or remove the command

Return to **Radius → Install Command Line Tool…** to repair the launcher or remove
it from your `PATH`. Removing the launcher does not uninstall Radius or affect
terminals opened inside Radius.

## Troubleshooting

### The shell says `radius: command not found`

Open a new terminal window after installation. If the command is still
missing, reopen the installer from Radius and choose **Repair**.

### The CLI cannot find Radius

Start Radius and wait for a browser window to appear, then run:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
radius doctor
```

### More than one Radius instance is running

The CLI will ask you to select an instance instead of guessing. See
[Multiple Radius instances](/docs/advanced/multiple-instances).