# ReasonOS Documentation

## Docs

- [ReasonOS](https://docs.reasonos.com/index.md): One build system, one server per branch, and agents that work the way you do.
- [Why ReasonOS](https://docs.reasonos.com/why-reasonos.md): What rbs gives you that Bazel-style and Nx-style setups don't.
- [Quickstart](https://docs.reasonos.com/quickstart.md): Install rbs, create a workspace, and build, run, and test your first targets.
- [Core concepts](https://docs.reasonos.com/core-concepts.md): Workspaces, packages, targets, the dependency graph, toolchains, the shared cache, environments, and branch nodes.
- [Example workspaces](https://docs.reasonos.com/examples.md): A guided tour of the runnable example workspaces that ship with rbs.
- [Packages and targets](https://docs.reasonos.com/build/packages-and-targets.md): How workspaces, build files, labels, and target patterns work in rbs
- [Everyday commands](https://docs.reasonos.com/build/commands.md): Build, test, run, query, graph, and coverage — the rbs commands you use all day
- [Environments and env files](https://docs.reasonos.com/build/environments.md): Declare, layer, and validate environment variables with .env files and a composable .env.schema
- [Caching](https://docs.reasonos.com/build/caching.md): How the shared content-addressed cache speeds up builds, and how to inspect and manage it with rbs cache.
- [Toolchains](https://docs.reasonos.com/build/toolchains.md): Hermetic, rbs-managed language toolchains: declare a version in your WORKSPACE and rbs downloads, caches, and shares it across workspaces.
- [External dependencies](https://docs.reasonos.com/build/external-dependencies.md): Declare npm, PyPI, and Go module dependencies in your workspace; rbs resolves them hermetically, locks them in rbs.lock, and shares them across workspaces.
- [Go](https://docs.reasonos.com/languages/go.md): Build, test, and cross-compile Go services with hermetic toolchains and offline module resolution
- [Node.js & TypeScript](https://docs.reasonos.com/languages/javascript.md): Build, run, and test Node.js and TypeScript code with rbs — hermetic toolchains, built-in npm dependency management, and coverage-gated tests
- [Web Apps](https://docs.reasonos.com/languages/web-apps.md): Build web frontends with the web-vite rules — a dev server with hot reload, production bundles, component tests with coverage gates, and module federation
- [Python](https://docs.reasonos.com/languages/python.md): Build, run, and test Python applications with hermetic toolchains and PyPI dependencies.
- [Java & Kotlin](https://docs.reasonos.com/languages/jvm.md): Build JVM applications with auto-downloaded JDK and Kotlin toolchains and Maven Central dependencies.
- [C, C++, .NET & Protocol Buffers](https://docs.reasonos.com/languages/other-languages.md): Reference for the C, C++, .NET, and Protocol Buffers rules.
- [Container images](https://docs.reasonos.com/deploy/containers.md): Package binaries into OCI container images with oci_image, and push them to a registry with oci_push — no Docker CLI required.
- [Deploying to Kubernetes](https://docs.reasonos.com/deploy/kubernetes.md): Declare Kubernetes workloads and manifests as build targets, then apply them to a cluster with rbs run — using a hermetically pinned kubectl.
- [Cluster jobs](https://docs.reasonos.com/deploy/jobs.md): Submit and manage batch work on an rbs cluster with rbs job — queues, priorities, dependencies, arrays, multi-node gangs, and content-addressed inputs and outputs.
- [Database migrations](https://docs.reasonos.com/deploy/migrations.md): Version your SQL schema with Flyway-style migrations for PostgreSQL, MySQL, and SQLite, driven by rbs migrate.
- [Infrastructure overview](https://docs.reasonos.com/infra/overview.md): Declare cloud infrastructure in .rbs files, right next to the code it serves, and manage its whole lifecycle with rbs infra.
- [Defining infrastructure](https://docs.reasonos.com/infra/defining-infrastructure.md): Write infrastructure in the build language: cloud-agnostic resources, environments, provider-specific types, and wiring services to what they use.
- [Infra commands](https://docs.reasonos.com/infra/commands.md): Every rbs infra subcommand: planning, applying, inspecting state, verifying against real providers, and generating typed resource catalogs.
- [CI Workflows](https://docs.reasonos.com/ci/overview.md): Define CI pipelines in .rbs files and run them with rbs ci — DAG execution over the same build graph, with affected-package detection built in.
- [Remote Cache & Execution](https://docs.reasonos.com/ci/remote-execution.md): Share build results across machines with the REAPI-compatible remote cache, and offload execution to workers with rbs remote.
- [Stacked branches](https://docs.reasonos.com/workflow/stacks.md): Work in stacks of small, dependent branches with rbs stack — create, restack, absorb review feedback, and submit one change request per branch.
- [Workspace checkpoints](https://docs.reasonos.com/workflow/checkpoints.md): Snapshot your workspace with rbs checkpoint and roll back AI or agent changes safely — automatic save points before every agent turn, manual ones whenever you want.
- [Change proposals](https://docs.reasonos.com/workflow/proposals.md): File an advisory change proposal against another project with rbs propose — suggest what should change without needing a fork or a branch.
- [Task board](https://docs.reasonos.com/workflow/task-board.md): The branch-scoped kanban board in the ReasonOS editor — tasks that travel with the branch through git, shared by everyone (and every agent) on that branch.
- [The ReasonOS Editor](https://docs.reasonos.com/editor/overview.md): A web-based IDE that connects to a branch node — one live development environment per branch, shared by everyone working on it.
- [Code Editing](https://docs.reasonos.com/editor/code-editing.md): The hands-on guide to working with code in the ReasonOS editor: navigating files, editing, searching, running targets, terminals, and reviewing changes on your branch.
- [Collaboration](https://docs.reasonos.com/editor/collaboration.md): Work on a branch together: one shared node per branch, live presence and co-editing, and a durable record of the work committed with the branch itself.
- [Language Intelligence](https://docs.reasonos.com/editor/language-intelligence.md): Completions, diagnostics, and hover documentation for every language in your workspace — provisioned automatically by the branch node, with zero manual setup.
- [Atlas](https://docs.reasonos.com/editor/atlas.md): The symbol-level knowledge graph of your branch — search it, ask it questions, trace call paths, and see the blast radius of a change.
- [Git in ReasonOS](https://docs.reasonos.com/platform/git.md): Every project is a git repository — host it on ReasonOS or point at any existing remote, browse it with nothing running, and open any branch as a live workspace.
- [Change requests](https://docs.reasonos.com/platform/change-requests.md): Propose a branch for review, discuss it line by line with commit-pinned threads, and land it — from the product or from rbs stack submit.
- [Hosted CI](https://docs.reasonos.com/platform/ci.md): How ReasonOS runs your CI workflows off your machine — push and change-request triggered runs, live logs and pipeline views, required checks, secrets, and environments.
- [Automated QA](https://docs.reasonos.com/platform/qa.md): Plain-English QA tests executed by AI agents in a real browser — with per-step screenshots, session replay, and verdicts written as bug reports.
- [Organizing work](https://docs.reasonos.com/platform/work.md): How work is organized in ReasonOS: the branch is the unit of work, and everything about that work — tasks, plans, chats, agent memory — is committed with it and travels through git.
- [Coding Agent Overview](https://docs.reasonos.com/agents/overview.md): The ReasonOS coding agent is built into rbs — it works from your workspace's dependency graph and builds, tests, and runs code through the build system itself.
- [Using the Agent](https://docs.reasonos.com/agents/using-the-agent.md): Run the coding agent from the terminal: interactive sessions, one-shot prompts, model selection, permission modes, and headless agent tasks.
- [Agent Skills](https://docs.reasonos.com/agents/skills.md): Skills are loadable units of expertise — how to work in your repository. The agent ships a built-in corpus and learns new skills from your workspace.
- [MCP Integration](https://docs.reasonos.com/agents/mcp.md): rbs speaks the Model Context Protocol in both directions: serve rbs tools to any MCP client, and connect external MCP servers to the rbs agent.
- [CLI Overview](https://docs.reasonos.com/reference/cli/overview.md): Every rbs command, its global flags, and how target labels work.
- [Build Commands](https://docs.reasonos.com/reference/cli/build-commands.md): Build, test, and run targets; query the target graph; generate coverage.
- [Workspace Commands](https://docs.reasonos.com/reference/cli/workspace-commands.md): Scaffold code, manage environments and caches, sync dependencies, and manage external rules.
- [Platform Commands](https://docs.reasonos.com/reference/cli/platform-commands.md): The RBS server, coding agent, Atlas knowledge graph, MCP integration, stacked branches, checkpoints, and proposals.
- [Operations Commands](https://docs.reasonos.com/reference/cli/operations-commands.md): Infrastructure, CI workflows, cluster jobs, database migrations, and remote build services.
- [The RBS Language](https://docs.reasonos.com/reference/dsl.md): The Python-like .rbs build language — file types, load(), predeclared symbols, labels, environments, and the gotchas that matter
- [Custom Rules](https://docs.reasonos.com/reference/custom-rules.md): Define your own build rules — native.define_rule, attribute types, the implementation function, and the full ctx API
- [External Rule Packages](https://docs.reasonos.com/reference/ext-packages.md): Load rules someone else wrote — the ext.rbs manifest, the rbs ext CLI, pinning, and authoring your own package

## OpenAPI Specs

- [openapi](https://docs.reasonos.com/api-reference/openapi.json)

## Optional

- [Blog](https://blog.reasonos.com)