Skip to main content
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.
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.

Set up the CLI

Use it immediately in Radius or add it to your regular terminal.

Run the quickstart

Open real tabs in one group and split only the local server.

Create startup scripts

Use the group and terminal IDs supplied by Radius.

Configure a project

Share environment, Git, worktree, and command behavior with your repository.

Browse the cookbook

Copy recipes for development workspaces and tab automation.

Command reference

See every available app, window, group, tab, and event command.

​
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

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. To configure the repository environment and the commands that invoke the CLI, see Project settings.