Skip to main content
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:
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:
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:
npm installations update through npm. App-owned launchers update when the Radius application updates.

​
Verify the connection

With Radius running:
If Radius is not running, start it from the CLI:
To print the CLI package version without connecting to Radius:

​
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:

​
More than one Radius instance is running

The CLI will ask you to select an instance instead of guessing. See Multiple Radius instances.