# CLI changelog

> What's new in each release of the relayrunner CLI.

Show: [All](/docs/changelog) · [Platform](/docs/changelog/platform) · **CLI** · [Mac app](/docs/changelog/mac)

Follow along with the [RSS feed](/changelog.xml).

## CLI v0.18.0

CLI release · November 20, 2026

### New

- `relayrunner blacksmith connect` connects your Blacksmith organization so Settings › Providers shows its real usage. You approve an org token in your browser as a Blacksmith org admin, and only that token is sent to RelayRunner. If Blacksmith's CLI isn't installed, it offers to download it into `~/.relayrunner/bin`.
- `relayrunner init` no longer skips a job just because it can request OIDC tokens (`id-token: write`), such as for a Turbo or Vercel remote cache. It's still a deploy job when it uses the token to sign in to a cloud or publish a package; otherwise it's ready, with a warning. `--allow-deploy <jobs>` routes jobs that look like deploy jobs, once you're fine giving the machine their secrets.

## CLI v0.17.0

CLI release · November 20, 2026

### New

- `relayrunner init --auto` writes `auto` in place of a Linux x64 job's runner label, so you set the job's size on the dashboard's Router page instead of in the workflow file. macOS and Arm jobs keep their labels.

## CLI v0.16.0

CLI release · November 19, 2026

### New

- The Mac Jobs window opens with the jobs it last showed and refreshes them in the background, and a job you've already opened shows its steps at once. Jobs running or waiting on the Mac come first. Filter by result, repo, workflow and time, and drag the line between the list and the job to resize them. Clicking a job in the menu's History tab opens it in the Jobs window. `relayrunner jobs` lists running jobs first and gains `--repo`, `--workflow`, `--result` and `--since`.

## CLI v0.15.0

CLI release · November 18, 2026

### New

- `relayrunner init` recognises Lizard labels (`lizard-medium-ubuntu-2404` and the like), keeps them as a job's fallback, and writes relays pinned to `relay.yml@v1.0.0-beta.8`, which takes a `lizard` input.
- RelayRunner for Mac has a Jobs window (Jobs… in the menu, ⌘J while it's open). It lists every job the Mac ran in the last week, sortable by how long each waited and ran. Pick one to see its steps on a timeline and, for a failed job, the step that failed, GitHub's annotations, the end of its log and, when the workspace has AI on, the likely cause. The CLI gains `relayrunner jobs` and `relayrunner jobs <id>`, which read the same from the gateway with the machine's own token.

## CLI v0.14.0

CLI release · November 18, 2026

### New

- `connect` keeps a history of the jobs it runs in `~/.relayrunner/history.jsonl`, and `relayrunner history` lists them with each one's result and time. When it starts a job it now names it, and with `--events` the `run` event says which job it is and how long it usually takes on this machine.
- `relayrunner init` recognises StarSling, Monk CI, Runloft, Latchkey, BerryBox, Celesto and InstaBox labels, keeps them as a job's fallback, and writes relays pinned to `relay.yml@v1.0.0-beta.7`, which takes an input for each.
- The Mac menu and `connect --events` now say how many jobs are waiting for a slot on this machine.

### Fixes and improvements

- The Mac menu's Queue names each waiting job and its workflow once GitHub has said which job it is. When jobs went to hosted runners because every slot was busy, a button allows one more job at once: the app pauses new jobs, waits for the running ones to finish, and comes back with the extra slot, or goes back to the earlier setting if it can't.
- The Mac menu has Now, Queue and History tabs. Queue lists the jobs waiting for this Mac and how long each has waited, and says when jobs went to hosted runners in the last hour because every slot was busy. History shows the last 12 hours as a bar per hour, with the latest jobs, all or only failed. `connect --events` adds `queue` and `spilled` to `waiting` and `state`.
- The Mac menu shows a row for each job slot, free ones included, with a bar against each job's usual time, and this Mac's CPU and memory while the menu is open. `connect --events` says how many slots the machine has in `state`.
- New installs connect to https://app.relayrunner.dev and link to relayrunner.dev. Machines already connected keep their saved server, https://app.relayrunner.app, which keeps working.

## CLI v0.13.2

CLI release · November 18, 2026

### Fixes and improvements

- `connect --events` reports each job's result, so the Mac app can tell you when a job fails.

## CLI v0.13.1

CLI release · November 17, 2026

### Fixes and improvements

- The Runners page shows when a machine runs through the Mac app, with the app's version beside its CLI's.

## CLI v0.13.0

CLI release · November 17, 2026

### New

- `relayrunner` is now a native binary rather than a Node.js program, so it's a smaller download and starts faster. npm installs the one for your computer, and the commands are the same.

## CLI v0.12.0

CLI release · November 16, 2026

### New

- `relayrunner init` recognises Boat labels (`boat`, `boat-large` and the like), keeps them as a job's fallback, and writes relays pinned to `relay.yml@v1.0.0-beta.6`, which takes a `boat` input.
- `connect --events` writes JSON events to stdout and takes `pause` or `resume` on stdin, for apps that run `connect`. Only one `connect` runs on a computer at a time now.

### Fixes and improvements

- `relayrunner workspaces list --json` includes each workspace's logo.

## CLI v0.11.0

CLI release · November 15, 2026

### New

- `connect` now keeps GitHub's runner up to date while it stays open. Every 6 hours it checks for a newer release and switches to it between jobs, so a job that's running finishes on the runner it started with. Before, a machine left connected for weeks fell behind until GitHub stopped sending it jobs.

## CLI v0.10.1

CLI release · November 14, 2026

### Fixes and improvements

- When the gateway refuses a request, `pause`, `share`, `whoami` and `workspaces` now show its reason and error code, such as "Only a machine with an owner can do this (MACHINE_NOT_OWNED)", instead of only the HTTP status.

## CLI v0.10.0

CLI release · November 13, 2026

### New

- Report how much CPU and memory each job uses. The dashboard's History page shows it for jobs on your machine.

## CLI v0.9.2

CLI release · November 13, 2026

### Fixes and improvements

- `relayrunner connect` now tells the dashboard how many CPUs and how much memory each job VM gets, so the Runners and Performance pages can show it.

## CLI v0.9.1

CLI release · November 12, 2026

### Fixes and improvements

- `relayrunner connect` now checks that its Linux VMs can look up hostnames before it builds the job image. When they can't, often because of VPN or DNS filtering software that's still running when its app is closed, it says so and how to check, instead of failing to build the image.

## CLI v0.9.0

CLI release · November 12, 2026

### New

- `relayrunner firewall on` adds a firewall on your Mac for isolated jobs. Job VMs can reach the internet, not your Mac or your local network, and no job can remove it, even with Docker. It asks for your password, stays on after a restart, and `relayrunner firewall off` removes it.
- On a Mac with Apple silicon and Apple's container tool, `connect` now runs each job in its own Linux VM, away from your files. `--macos` also takes macOS jobs on the Mac itself, and `--no-isolated` runs every job there. Without the container tool, jobs run on the Mac and `connect` says how to set it up.

  New `--cpus` and `--memory` flags set the size of each job's VM, like a hosted runner's size. With a size and no `--concurrency`, as many jobs run at once as fit.

- `relayrunner connect --isolated --macos` takes both kinds of job on one Mac. Linux jobs run in a VM, and macOS jobs such as Xcode builds run on the Mac itself.
- Isolated jobs now find the everyday tools a job written for `ubuntu-latest` expects: Node with npm, pip, compilers and `make`, `wget`, `zip`, Git LFS, Docker Compose and the `gh` CLI. An image given with `--image` is used as it is.

### Fixes and improvements

- License the CLI under Apache 2.0 and ship the LICENSE file in the npm package.
- `connect` says where jobs run when it starts, and how to take macOS jobs too. With `--macos` or `--no-isolated` it warns that those jobs can read your files.
- `init` no longer warns about Docker or Linux packages on a Mac that runs jobs in a VM.

## CLI v0.8.0

CLI release · November 12, 2026

### New

- Docker works in isolated jobs. `relayrunner connect --isolated` now starts Docker inside each job's VM, so jobs with `services:`, `container:` or `docker build` run. `--local-network` uses the same job image as the default, so it builds that image once too.
- `relayrunner connect --isolated` (experimental) runs each job in its own Linux VM on a Mac with Apple silicon, using Apple's `container` tool. The VM starts from GitHub's runner image with none of your files mounted, can reach the internet but not your Mac or local network, and is deleted when the job ends. `--local-network` lets jobs reach your network, and `--image` starts from another runner image. `connect` removes the images it got for older runner versions, and keeps a log of what it did in `~/.relayrunner/isolated.log`.
- `relayrunner workspaces` shows which of your workspaces this machine runs jobs in and which it doesn't, with its sharing. `relayrunner workspaces add <name>` and `remove <name>` change that, by workspace name, slug or id, or from a list when you leave the name out. Adding a workspace while the machine runs anyone's jobs warns that anyone who can push to that workspace's private repos can run jobs on it. After you approve a new machine, `connect` prints the workspaces it runs jobs in and how to change them, and `connect` and `whoami` tell a machine that isn't in any of your workspaces apart from an account with no workspace yet.

### Fixes and improvements

- `relayrunner connect` suggests `--isolated` on Macs that can use it.
- After its connection drops, `relayrunner connect` waits a few random seconds before reconnecting, so machines don't all reconnect at the same moment after a RelayRunner update.

## CLI v0.7.0

CLI release · November 11, 2026

### New

- `relayrunner connect` tells you when npm has a newer `relayrunner`, with the command that updates it (`npx relayrunner@latest connect`, or `npm install --global relayrunner@latest` for a global install). It asks npm at most once a day, in the background, so it never slows down connecting, and a `connect` left running checks again each day. It only checks when someone is at the terminal and not in CI. `connect` also tells the gateway which CLI version the machine runs, and `relayrunner --version` prints it.
- `relayrunner connect` runs several jobs at once: 2 on a computer with 8 or more CPU cores, otherwise 1. `--concurrency <n>` changes it. Each slot runs its jobs in its own copy of the runner (`~/.relayrunner/runner/<version>/slot-<n>/`), and with more than one slot each line of a job's output starts with its slot.

## CLI v0.6.0

CLI release · November 11, 2026

### New

- A machine is now in every workspace you're a member of, so signing in no longer means picking one. `relayrunner connect` and `login` print the workspaces the machine is in, and `whoami` lists them. The sharing question shows when any of your workspaces has someone else in it, and `anyone` means any job in your workspaces. If you aren't in a workspace yet, signing in still works: the CLI says so and links to the GitHub install, and the machine takes jobs once you're in one. `~/.relayrunner/machine.json` no longer saves a workspace, and files from earlier versions still load.
- `relayrunner init` keeps a job's Depot, Namespace, WarpBuild, Ubicloud or RunsOn label as its fallback, the same way it keeps a Blacksmith label.

## CLI v0.5.0

CLI release · November 11, 2026

### New

- `relayrunner connect` now names its terminal tab after the machine and what it's doing, such as "RelayRunner · M3P0 · Waiting for jobs", "Running a job" or "Paused", and puts the old title back when it exits. Press `p` to pause or resume the machine without disconnecting, the same as pausing it on the Runners page.

### Fixes and improvements

- On a Mac without a hostname of its own, the suggested machine name is now the Computer Name from System Settings (such as "Zach's MacBook Pro") instead of a generic one like `Mac.local`. A hostname you set still comes first. The download message also says that `actions/runner` is GitHub's official runner.

## CLI v0.4.0

CLI release · November 11, 2026

### New

- `relayrunner connect` gets a new machine token from the gateway each time it comes online and the old one stops working, so a copied `machine.json` can't sign in as the machine for long. If another copy does sign in while this one is online, the person who approved the machine gets an email.

  Before it runs a job, `connect` checks the job's runner config: only GitHub's files, only GitHub servers over https, and a runner named for that job. Anything else is refused and reported as a failed job. The terminal now shows which repo each job is from.

  `--server`, `RELAYRUNNER_URL` and saved sign-ins must use https, except for `localhost` while developing.

  The sharing prompt now says that "Anyone in the workspace" only covers jobs from repos you can open.
