> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reasonos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Why ReasonOS?

> See how RBS compares to traditional build systems and why teams are switching

# Why ReasonOS?

Modern development teams juggle dozens of tools — build systems, CI/CD platforms, infrastructure tools, linting frameworks, container builders, and more. RBS replaces all of them with a single, unified platform.

## The problem with today's tooling

<CardGroup cols={2}>
  <Card title="Tool sprawl" icon="toolbox">
    Teams manage 10–20+ separate tools for builds, tests, CI, infrastructure, containers, linting, and deployment — each with its own configuration format and maintenance overhead.
  </Card>

  <Card title="Slow onboarding" icon="clock">
    New engineers spend days or weeks setting up local environments. "Works on my machine" remains the most common debugging excuse.
  </Card>

  <Card title="Fragile CI pipelines" icon="link-slash">
    YAML-based CI configurations are brittle, hard to test locally, and disconnected from the build system. A passing local build doesn't guarantee CI success.
  </Card>

  <Card title="No collaboration" icon="users-slash">
    Developers work in isolation. Code review is asynchronous. Pair programming requires third-party screen sharing. There's no shared understanding of what's happening in the codebase.
  </Card>
</CardGroup>

## How RBS solves it

RBS is a **managed cloud development platform** that consolidates building, testing, deploying, linting, infrastructure provisioning, container building, and real-time collaboration into a single tool — all accessible from your code editor.

<Steps>
  <Step title="One tool, not twenty">
    Replace Bazel + Jenkins + Terraform + Docker + ESLint + Prettier + Slack + Zoom + GitHub Actions with a single `rbs` command.
  </Step>

  <Step title="Zero local setup">
    Every branch gets a dedicated build server in the cloud. Open your editor, connect, and start building. No local toolchains, no Docker, no environment issues.
  </Step>

  <Step title="Hermetic by default">
    Every build is reproducible. RBS manages all toolchains — compilers, runtimes, formatters, linters — in isolated, versioned environments. No system dependencies.
  </Step>

  <Step title="Built-in collaboration">
    Edit code together in real-time. Video call without leaving your editor. Share your screen. Chat with code snippets. See who's working on what.
  </Step>
</Steps>

***

## RBS vs the alternatives

### Build systems

|                             | RBS                     | Bazel                 | Nx                 | Make             |
| --------------------------- | ----------------------- | --------------------- | ------------------ | ---------------- |
| **Learning curve**          | Hours                   | Weeks                 | Days               | Hours            |
| **Setup time**              | Instant (managed)       | Hours–Days            | Minutes            | Minutes          |
| **Hermetic builds**         | ✅ Always                | ✅ Yes                 | ❌ No               | ❌ No             |
| **Single binary**           | ✅ Yes                   | ❌ Requires Java       | ❌ Requires Node.js | ✅ Yes            |
| **Rule authoring**          | Minutes (same file)     | Hours (multi-file)    | npm package        | Makefile targets |
| **Watch mode / hot reload** | ✅ Built-in `--watch`    | ❌ External (`ibazel`) | ✅ Built-in         | ❌ External       |
| **Lint SDK**                | ✅ Any linter, SDK-first | ❌ Manual setup        | Plugin-based       | ❌ Manual         |
| **AI coding agent**         | ✅ Built-in              | ❌                     | ❌                  | ❌                |

### CI/CD platforms

|                           | RBS                     | GitHub Actions | GitLab CI      | Jenkins     |
| ------------------------- | ----------------------- | -------------- | -------------- | ----------- |
| **Configuration**         | RBS DSL (testable)      | YAML           | YAML           | Groovy/YAML |
| **Local testing**         | ✅ Same commands locally | ❌              | ❌              | ❌           |
| **Affected-only builds**  | ✅ Built-in              | ❌ Manual       | ❌ Manual       | ❌ Manual    |
| **DAG-based execution**   | ✅ Native                | Limited        | Limited        | ✅ Pipelines |
| **Distributed execution** | ✅ Built-in              | Shared runners | Shared runners | Agent-based |

### Infrastructure tools

|                            | RBS                          | Terraform       | Pulumi          | CloudFormation  |
| -------------------------- | ---------------------------- | --------------- | --------------- | --------------- |
| **Language**               | RBS DSL                      | HCL             | General-purpose | YAML/JSON       |
| **Provider support**       | 5000+ (Terraform-compatible) | 5000+           | 100+            | AWS only        |
| **Integrated with builds** | ✅ Same tool                  | ❌ Separate tool | ❌ Separate tool | ❌ Separate tool |
| **Plan/Apply workflow**    | ✅ Yes                        | ✅ Yes           | ✅ Yes           | ✅ Changesets    |
| **State management**       | ✅ Built-in                   | ✅ Yes           | ✅ Yes           | ✅ Yes           |

### Collaboration tools

|                            | RBS              | VS Code LiveShare | CodeTogether | Tuple |
| -------------------------- | ---------------- | ----------------- | ------------ | ----- |
| **Real-time editing**      | ✅ Built-in       | ✅ Extension       | ✅ Plugin     | ❌     |
| **Video calls**            | ✅ Built-in (P2P) | ❌                 | ❌            | ✅     |
| **Screen sharing**         | ✅ Built-in (P2P) | ❌                 | ✅            | ✅     |
| **Team chat**              | ✅ Built-in       | ❌                 | ❌            | ❌     |
| **Presence tracking**      | ✅ Cross-feature  | ✅ Basic           | ✅ Basic      | ❌     |
| **Integrated with builds** | ✅ Same platform  | ❌                 | ❌            | ❌     |

***

## What teams are saying

<CardGroup cols={1}>
  <Card title="Replaced 12 tools with one platform">
    "We eliminated GitHub Actions, Terraform, Docker, ESLint, Prettier, Slack for dev chat, Tuple for pairing, and more. Our engineers now have one tool to learn and one place to work."
  </Card>

  <Card title="Onboarding went from days to minutes">
    "New engineers clone the repo, open their editor, and connect to RBS. No local setup, no Docker compose, no environment variables. They're productive on day one."
  </Card>

  <Card title="CI that actually matches local builds">
    "With RBS, there's no difference between a local build and a CI build. The same hermetic environment runs everywhere. 'Works on my machine' is a thing of the past."
  </Card>
</CardGroup>

***

## Key differentiators

<Columns cols={3}>
  <Card title="SDK-first extensibility" icon="puzzle-piece">
    Define custom build rules, linters, and toolchains using the RBS DSL. No plugin systems, no package managers — just configuration.
  </Card>

  <Card title="Managed build servers" icon="server">
    Every branch gets a dedicated server. Builds run in the cloud with shared caching. Your laptop stays cool.
  </Card>

  <Card title="Real-time collaboration" icon="users">
    Edit code together, video call, screen share, and chat — all built into the platform. No third-party tools needed.
  </Card>

  <Card title="AI-powered development" icon="robot">
    A built-in coding agent that understands your builds, modifies code, runs tests, and coordinates multi-agent teams.
  </Card>

  <Card title="Hermetic everything" icon="lock">
    Toolchains, dependencies, linters, formatters — all managed and versioned. Builds are reproducible across every environment.
  </Card>

  <Card title="Any language" icon="code">
    Python, Java, Node.js, TypeScript, Kotlin, Go, C/C++ — all with managed toolchains and consistent build rules.
  </Card>
</Columns>

***

<Card title="Ready to try it?" icon="rocket" href="https://reasonos.com/get-started" horizontal>
  Get started with RBS and see the difference for yourself.
</Card>