docs

From a branch to a first build. Then the reference.

Everything below is what the tools do today, in the branch a workspace gives you. The full reference is at docs.reasonos.com.

Quickstart

01

Open a branch

Every branch runs on its own server with rbs already on it. Nothing to install: the editor, the terminal and the build are in the browser.

reasonos://acme/checkout · new branch feat/first-build
02

Build in the branch terminal

No configuration to start: rbs detects Go modules, Node and Vite apps, Python packages and more, and generates what it needs.

rbs build //...
03

Keep the generated config

Writes the same files rbs just used, byte for byte, so nothing changes when you commit them.

rbs adopt
04

Test with a floor

Declare a coverage floor on a test target and the build fails below it.

rbs test //services/api:test
05

Hand a task to an agent

The agent works in the same branch with the same tools, and ends in a change request that passes the same gates.

rbs agent "add a regression test for the retry ceiling"
load("@rbs//go/rules.rbs", "go_binary", "go_test")

go_binary(
    name = "server",
    srcs = glob(["*.go"]),
    deps = ["//libs/money"],
)

go_test(
    name = "test",
    srcs = glob(["*_test.go"]),
    min_line_coverage = 80,
)

rbs --help

The command line.

One binary, twenty-five commands. Each has its own --help.

adoptConvert an existing repository into an rbs workspace
agentRun the coding agent
atlasSymbol-level knowledge graph of the workspace
buildBuild a target
cacheManage the shared content-addressed store
checkpointWorkspace snapshots for reverting agent changes
ciRun CI workflows as a DAG
coverageGenerate coverage reports
envInspect and validate the workspace environment
extManage external rule packages
graphThe unified workspace dependency graph
infraManage infrastructure defined in Starlark
jobSubmit and manage cluster jobs
mcpMCP server and client management
migrateManage SQL database migrations
proposeFile a change proposal against another project
queryList and inspect build targets
remoteRemote cache, workers and cluster status
rulesManage and test rules
runRun a target, or several in parallel
scaffoldGenerate code from a scaffolding template
serverStart the branch node: terminal, files, LSP, agent, proxy
stackWork in stacks of small, dependent branches
syncSync external dependencies for LSP support
testRun tests

Every command above exists in the current release; this list is regenerated from the binary.