Source: https://openrunners.io/quickstart/

# Quick start

Two paths: your coding agents' tests and builds, and your GitHub Actions CI.

## Coding agents: Crabbox

[Crabbox](https://crabbox.sh/) ([github.com/openclaw/crabbox](https://github.com/openclaw/crabbox), MIT) leases a machine, syncs your working tree including uncommitted changes, runs your command, streams the output and returns its exit code. Agents learn it through a skill, so it works in Claude Code, Codex and other harnesses. It is built and maintained by the openclaw project; we just use it and recommend it.

1. Install: `brew install openclaw/tap/crabbox crabbox doctor`
2. Try it with no account, on Docker or Podman on your own machine: `crabbox run --provider local-container -- pnpm test`
3. See which providers can run Linux jobs, then pick one: `crabbox providers --target linux`

Crabbox's [getting started guide](https://crabbox.sh/) covers providers, warm reuse and agent skills.

## CI: switch `runs-on`

Hosted runners keep GitHub Actions as it is: workflows, secrets and logs stay in GitHub, and only the machine behind `runs-on` changes. Most providers follow the same three steps: install the provider's GitHub App, change the label, merge. Pick a runner from the [benchmark](https://openrunners.io/benchmark/); the example below uses the lowest-priced one, Sengi Basic.

1. **Connect your repository.** Sign in at [app.sengi.run](https://app.sengi.run/), choose *Set up GitHub connection* and install the Sengi GitHub App. Choose *Only select repositories* to limit its access. No card is needed to start.
2. **Change one line per job** and keep everything else: `jobs: test: runs-on: sengi-basic-4-ubuntu-2404 steps: - uses: actions/checkout@v5 - run: npm ci - run: npm test` Labels are `sengi-basic-2-ubuntu-2404`, `-4-` and `-8-` for 2, 4 and 8 vCPU, or `premium` in place of `basic` for the faster tier. Write the label literally, one per job.
3. **Push and merge** through your usual review. Branch rules and approvals still apply.

Prefer to let your coding agent do it? Give it the Sengi prompt: `curl -s https://sengi.run/agent.md`. It changes only `runs-on` lines and opens a pull request for you to review. To switch back, change the label back.

Other providers use their own labels; each one's docs are linked from its row in the [benchmark](https://openrunners.io/benchmark/). Prices for this example: Sengi Basic is $0.001, $0.002 and $0.004 a minute at 2, 4 and 8 vCPU with 3,000 free minutes a month; Premium is $0.003, $0.006 and $0.012.


openrunners is maintained by engineers who also build Sengi (https://sengi.run/), one of the runners listed.
