pcbbugs-runner 0.1.0 — macOS

This machine runs a Vibe In One board's agent work: it dials out to your
workspace, picks up cards assigned to the AI assignee, does the work in a
checkout of your own repository and comes back with a diff you review on the
card.

Nothing listens on this machine. The runner makes outbound requests only, so
there is no port to open and no firewall rule to add.


BEFORE YOU START

  * Node 20 or newer, and git.
  * An agent CLI — `claude` (https://claude.com/claude-code) or `opencode`
    (https://opencode.ai) — installed AND logged in as the user that will run
    the service. An installed-but-logged-out CLI is the most common reason a
    machine comes online and then fails its first card; the installer checks
    for it and will not leave you guessing.
  * The workspace URL and a token. In Vibe In One: Settings -> Runner machines ->
    Add machine. It shows both, once. The token is good for fifteen minutes
    and can be used once.


INSTALLING

  1. Unpack this archive, if you have not already.
  2. In a terminal:

  cd pcbbugs-runner-0.1.0
  ./install.sh

  3. Paste the workspace URL when it asks, then the token.
  4. It checks this machine, registers with the workspace before it writes
     anything, and installs itself as nothing as a service — macOS is not a supported target, so the installer prints the command to run it with.
  5. It then waits until your board has heard from this machine, and says so.

You can pass both values instead of being asked:

  ./install.sh https://your-workspace --token <token>

Re-running the installer is safe.


AFTERWARDS

  The machine appears in Settings -> Runner machines with a green dot. Its
  logs are at:

  wherever you are running it from — it prints to the terminal

  If it does not appear:

  * The board says why. Open Settings -> Runner machines and read the row:
    a machine that registered but is not checking in, an agent CLI that is
    not logged in, and a machine nobody ever ran the installer on are three
    different problems and the page names which one it is.
  * The installer prints the exact command to read the service's own log with.
    Run it — an install that finished cleanly and a service that will not
    start look identical from the board.
  * `pcbbugs-runner uninstall` removes the service; running the installer
    again is safe and is usually quicker than working out what changed.


UPDATING

  Settings -> Runner machines -> Update it. A machine installed from this
  archive is updated by downloading the current one from
  https://vibeinone.ca/download/runner and running the installer again.


LICENCE

  See LICENSE in this archive. It grants running the runner on your own
  machines for as long as you hold a Vibe In One workspace, and nothing else.
