Quickstart

Install the GitHub App

Sign in with GitHub and install the Play Compute App on your organization. Choose the repositories it may serve; it reads workflow files and job events, never your secrets.

The App opens one pull request that changes runs-on in every workflow it finds, with a size suggested for each job.

Pick a size

A job runs on Play Compute when its runs-on names one of the play labels. Memory grows with the job up to the size's limit and is given back when freed.

jobs:
  test:
    runs-on: play-4vcpu
    steps:
      - uses: actions/checkout@v4

The playc command

playc reads runs and logs, reruns jobs and opens a shell into a running job from your terminal or your agent's.

Install it, then connect it from the app's Connect a machine button.

The API

Org API tokens, made under Settings, call the same API the app uses: runs, jobs, logs, usage, cache and artifacts.

Send the token as Authorization: Bearer <token>.