Skip to main content
A startup script is an ordinary executable shell script. It does not require a Radius SDK or separate runtime.

​
How startup works

When you create a configured project or worktree group, Radius:
  1. Creates the group.
  2. Opens its terminal tab.
  3. Starts the configured command.
  4. Provides the current group, terminal, and window IDs.

​
Create the script

Save this as scripts/open-radius-workspace.sh:
Make it executable:

​
Configure the group

Open the project group’s menu, choose Settings, then set Startup command under Scripts to:
Or add the same command to .radius/settings.toml:
The next time you create the project or worktree group, Radius runs the script in its terminal.
Startup arranges the Radius group. It is separate from the setup command that installs dependencies inside a newly created worktree. See Scripts and automation.

​
Failure behavior

Completed commands remain visible if a later command fails. Radius does not roll back the group or keep enforcing the layout after the script exits. Use set -euo pipefail, validate required variables at the top, and use tab wait when a later step depends on a page finishing navigation.