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>.