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

# CLI troubleshooting

> Repair or diagnose the Radius command in an external terminal.

The Radius app includes the CLI and makes it available automatically in
terminals opened by Radius. On first launch, Radius also creates
`~/.local/bin/radius` for external terminals and adds that directory to your
shell `PATH` when needed.

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

Open a new terminal window after Radius starts. If the command is still missing,
run:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
echo $PATH
```

Confirm the output contains `$HOME/.local/bin`. Then choose
**Radius → Repair Terminal Command…** and open another terminal window.

## Repair the terminal command

Choose **Radius → Repair Terminal Command…** to check the launcher, shell
`PATH`, bundled CLI version, and login-shell configuration. Radius repairs a
missing, stale, or broken Radius-owned launcher without replacing another
command at the same path.

<img src="https://mintcdn.com/inspector-12805d8f/XifxWshzhd_l_q9V/images/repair-terminal-command-menu.png?fit=max&auto=format&n=XifxWshzhd_l_q9V&q=85&s=8248ee5fc6bd686e7f93c6c0b929036e" alt="The Radius application menu showing Repair Terminal Command" width="417" height="315" data-path="images/repair-terminal-command-menu.png" />

Radius supports automatic `PATH` setup for zsh, bash, sh, and fish. For another
shell, add this directory to your `PATH`:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
$HOME/.local/bin
```

## A different `radius` command runs

Run:

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

The app-managed command is `$HOME/.local/bin/radius`. If another command appears
first, adjust your `PATH` only if you want the app-bundled CLI to take
precedence.

## Verify the app connection

With Radius running:

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

## Install the standalone npm package

Most users should use the CLI included with Radius. For a standalone
installation, macOS and Node.js 20 or newer are required:

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

npm installations update through npm. The CLI included with Radius updates
when the app updates.

## More than one Radius instance is running

The CLI asks you to select an instance instead of guessing. See
[Multiple Radius instances](/docs/radius-cli/multiple-instances).