RunBuoy
  • English

      • Quick Start

      RunBuoy keeps long-running commands, builds, experiments, and agent runs on your computer visible on iPhone.

      Requirements

      • macOS or Linux
      • Python 3.12 or newer
      • tmux for durable runs
      • The RunBuoy iOS app

      1. Install tmux

      macOS
      Debian / Ubuntu
      brew install tmux

      2. Install RunBuoy

      uv (recommended)
      pipx
      uv tool install runbuoy
uv tool update-shell
runbuoy completion install zsh

      Restart your terminal, then verify the environment:

      runbuoy doctor
runbuoy capabilities --json

      3. Pair your iPhone

      Open RunBuoy, choose “Pair New Machine,” then run this command on your computer:

      runbuoy device pair

      Scan the QR code. The challenge expires after five minutes, works only once, and contains no long-lived credential.

      4. Start a run

      runbuoy demo live-activity
runbuoy run -- python3 experiment.py

      The command keeps running on your computer while iPhone displays carefully scoped status, progress, timing, and results.

      Next steps