Skip to content

CLI changelog

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

Show: All · Platform · CLI · Mac app

Follow along with the RSS feed.

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.