# Sorus

Run Cargo check, build and test in the cloud. Beta access by agreement.

Documentation revision: 4595b28fdd7793285d6cef71eaeaaa9f6052b130. The support matrix lists candidate workloads; onboarding confirms availability.

## tutorials

Learn by completing a first Sorus job.

- [run your first Cargo check](https://www.sorus.run/docs/quickstart): Sign in, submit one Cargo check and inspect its result. For: Rust developers new to Sorus

## how-to guides

Follow steps for a specific task.

- [authenticate the CLI](https://www.sorus.run/docs/guides/authentication): Configure interactive or unattended access to an authorised repository. For: CLI users; CI and agent credential setup
- [prepare source and resume an upload](https://www.sorus.run/docs/guides/source): Check captured inputs and recover an interrupted submission without creating a new job. For: Advanced: source uploads and recovery
- [inspect and recover a job](https://www.sorus.run/docs/guides/results): Choose the next action after a job result, disconnect or cancellation. For: Advanced: job recovery and CI automation
- [read logs and download artifacts](https://www.sorus.run/docs/guides/artifacts): Inspect a job and retrieve the outputs selected for collection. For: Rust developers exporting job outputs
- [run Sorus from CI](https://www.sorus.run/docs/guides/ci): Add a supported Cargo job to an existing CI workflow and handle its result. For: Advanced: existing CI workflows
- [connect a coding agent](https://www.sorus.run/docs/guides/agents): Give an agent scoped access to Sorus through the CLI, API or MCP. For: Advanced: coding agents and MCP
- [select and verify a toolchain](https://www.sorus.run/docs/guides/toolchains): Request a supported compiler version and check the resolved build inputs. For: Rust developers using pinned toolchains
- [troubleshoot a failed job](https://www.sorus.run/docs/guides/troubleshooting): Diagnose authentication, submission, execution and download failures. For: Rust developers diagnosing a Sorus job

## reference

Look up commands, interfaces and supported workloads.

- [supported workloads](https://www.sorus.run/docs/supported-workloads): Cargo operations, toolchains, machine classes and restrictions. For: Rust developers checking workload compatibility
- [versions & availability](https://www.sorus.run/docs/release-status): Documentation revision, beta availability and known limits. For: Rust developers checking beta availability
- [cli reference](https://www.sorus.run/docs/reference/cli): Generated CLI operation catalogue, pinned to the reviewed source revision. For: Rust and Cargo users looking up commands and flags.
- [api reference](https://www.sorus.run/docs/reference/api): Generated API operation catalogue, pinned to the reviewed source revision. For: Advanced integrations: developers implementing an HTTP client.
- [mcp reference](https://www.sorus.run/docs/reference/mcp): Generated MCP operation catalogue, pinned to the reviewed source revision. For: Advanced integrations: developers connecting MCP tools and agents.

## explanation

Understand how Rust CI and Sorus work.

- [how Sorus fits into a Rust workflow](https://www.sorus.run/docs/overview): The relationship between your workflow, cloud execution and a Sorus job. For: Rust developers evaluating Sorus
- [Rust CI basics](https://www.sorus.run/docs/learn/rust-ci): An introduction to Cargo operations, CI workflows and build caching. For: New to Rust CI
- [caching & reuse](https://www.sorus.run/docs/concepts/reuse): Why dependency caches, compiler outputs and warm build state avoid different work. For: Advanced: Rust build caching
- [pricing & usage](https://www.sorus.run/docs/billing): How the planned usage model relates to beta agreements and job outcomes. For: Teams evaluating beta costs
- [security boundaries](https://www.sorus.run/docs/guides/security): How source capture, credentials, execution and retention affect a security review. For: Advanced: security and data handling

## Machine-readable references
- [OpenAPI](https://www.sorus.run/reference/openapi.json)
- [Reference provenance](https://www.sorus.run/reference/provenance.json)
- [Support matrix](https://www.sorus.run/reference/supported-scope.json)
- [Pricing](https://www.sorus.run/pricing): Beta terms by agreement. Public rates are not yet available.
- [Benchmark methodology](https://www.sorus.run/benchmarks/methodology): Measurement rules and limitations of the early samples.