Command Reference
A reference for all built-in raid commands. For custom commands defined in your profile, see Custom Commands.
Global flags
| Flag | Description |
|---|---|
-c, --config <path> | Path to the config file (default: ~/.raid/config.toml) |
raid install
Clone all repositories in the active profile and run install tasks.
raid install [repo] [-t <threads>]
Behaviour:
- Clone all repositories concurrently (throttled by
-tif set) - Run profile-level install tasks
- Run each repository's install tasks in profile order
If a repository already exists at its configured path, cloning is skipped.
| Flag | Description |
|---|---|
[repo] | Install only the named repository (profile-level tasks are not run) |
-t, --threads | Max concurrent clone threads (default: unlimited) |
For more details, see Install.
raid env
Manage and apply environments.
raid env # show the active environment
raid env <name> # apply a named environment to all repos
raid env list # list available environments
Applying an environment writes each repository's configured .env file and runs its environment tasks.
For more details, see Env.
raid profile
Manage profiles.
raid profile create # interactive wizard to create a new profile
raid profile add <path|url> # register a profile from a local file, git URL, or raw file URL
raid profile list # list all registered profiles
raid profile <name> # switch the active profile
raid profile remove <name> # remove a profile
For more details, see Profile.
raid doctor
Check the active configuration for issues.
raid doctor
Doctor inspects the current profile and reports findings at three severity levels:
| Level | Meaning |
|---|---|
OK | No issues |
WARN | Something looks off but raid can still function |
ERROR | A problem that will prevent raid from working correctly |
Run raid doctor after initial setup or whenever something isn't working as expected.
For more details, see Doctor.
raid context
Print a condensed snapshot of the active workspace — profile, environment, and per-repository git state.
raid context # pretty-printed
raid context --json # machine-readable JSON
| Flag | Description |
|---|---|
--json | Emit machine-readable JSON instead of the human-readable table |
Output is intentionally token-efficient and bounded — useful for piping into a chat agent or another tool.
raid context serve
Run a Model Context Protocol server (stdio transport) that exposes the active workspace as resources and the raid agent toolkit as tools. Intended to be launched by an MCP host such as Claude Code or Cursor; the process blocks on stdin until the host disconnects.
raid context serve
For more details on either subcommand, see Context.
raid <command>
Run a custom command defined in the active profile or any of its repositories.
raid deploy
raid migrate
raid test-all
Custom commands are defined in commands sections of the profile or in individual repository raid.yaml files. Run raid --help to see all available commands.
Custom command names cannot shadow built-in or reserved names (profile, install, env, doctor, context, telemetry, help, version, completion).
To run a command from a specific repository (e.g. when profiles shadow a repo command with the same name):
raid <repo-name> <command>
raid backend test # run the "test" command from the backend repo
raid frontend build # run the "build" command from the frontend repo
Each repo with commands appears as a subcommand in raid --help. Run raid <repo> --help to list that repo's commands.
For more details, see Custom Commands.