CLI Overview - ReasonOS Documentation

RBS (ReasonOS Build System) is a self-contained build system that manages all toolchains internally and provides hermetic builds. This is the exhaustive command reference — every command and flag, exactly as the CLI reports them. This is syntax notation; replace the bracketed parts with a command and its options:

rbs [command] [flags]

Target labels and patterns

Most commands that operate on build targets accept labels in the same syntax:

Pattern	Meaning
`//package:target`	The target `target` in the package at `package/` (path from the workspace root)
`:target`	The target `target` in the current package (your working directory)
`:all`	Every target in the current package
`//package/...`	Every target under `package/`, recursively
`//...`	Every target in the workspace

build, test, run, and coverage also accept a natural syntax — a package path followed by one or more target names. For example, from the RBS source repository root:

rbs build examples/go-hello hello
rbs run examples/go-hello hello

rbs build examples/go-hello hello — builds hello in the examples/go-hello package; expect a successful build summary.
rbs run examples/go-hello hello — builds and runs the same target; expect Hello, World! (built with RBS).

Global flags

These flags are accepted by every command. Per-command flag tables on the other pages omit them (along with -h, --help, which every command supports).

Flag	Description
`--config`	Config file (default `$HOME/.rbs.yaml`)
`-e, --env`	Environment to build for, as declared by `env.environment()` in `.env.schema`. Also settable via `RBS_ENV`
`--platforms`	Target platforms to build for (e.g. `linux-amd64`); accepts multiple values
`--workspace-root`	Explicit path to the workspace root, overriding auto-discovery. Also settable via `RBS_WORKSPACE_ROOT`
`-v, --version`	Print the rbs version (top-level `rbs` only)
`-t, --toggle`	Placeholder flag reported by the CLI (“Help message for toggle”); not used by any command

Inside rbs infra, -e/--env takes a different meaning: it is an alias for the infra workspace (--workspace), e.g. dev, staging, prod. See rbs infra.

Shell completion

rbs completion [bash|zsh|fish|powershell] generates an autocompletion script for your shell. rbs help [command] prints help for any command — equivalent to rbs <command> --help.

All commands

Build

Command	Purpose
`rbs build`	Build one or more targets with dependency handling
`rbs test`	Run test targets
`rbs run`	Run a target, or several targets in parallel
`rbs query`	List and inspect build targets matching a pattern
`rbs graph`	Generate the unified workspace dependency graph
`rbs coverage`	Generate coverage reports for test targets

Workspace

Command	Purpose
`rbs scaffold`	Generate code from a scaffolding template
`rbs env`	Inspect and validate the workspace environment (`.env` files + `.env.schema`)
`rbs cache`	Manage the shared content-addressed store
`rbs sync`	Sync external dependencies for targets to enable LSP support
`rbs ext`	Manage external rule packages (`ext.rbs`)
`rbs rules`	Manage and test rules

Platform

Command	Purpose
`rbs server`	Start the RBS server with terminal, file API, AI agent, and proxy support
`rbs agent`	Run the coding agent (graph-first, multi-provider)
`rbs atlas`	Symbol-level knowledge graph of the workspace
`rbs mcp`	MCP (Model Context Protocol) server and client management
`rbs stack`	Work in stacks of small, dependent branches
`rbs checkpoint`	Manage workspace checkpoints for reverting AI changes
`rbs propose`	File a change proposal against another project

Operations

Command	Purpose
`rbs infra`	Manage infrastructure defined in .rbs files
`rbs ci`	Run CI workflows using RBS DAG execution
`rbs job`	Submit and manage cluster jobs (scheduler mode)
`rbs migrate`	Manage SQL database migrations
`rbs remote`	Remote build services (REAPI cache; execution and workers)

​Target labels and patterns

​Global flags

​Shell completion

​All commands

​Build

​Workspace

​Platform

​Operations

Target labels and patterns

Global flags

Shell completion

All commands

Build

Workspace

Platform

Operations