runbuoy 0.1.1

Read-only command status delivery for RunBuoy

RunBuoy CLI

RunBuoy keeps long-running commands visible from an iPhone without exposing a remote-control surface. The CLI runs commands locally, records structured status and progress, and sends a deliberately limited projection to a paired RunBuoy server.

Requirements

• macOS or Linux
• Python 3.12 or newer
• tmux for durable runs

Install tmux before RunBuoy:

# macOS
brew install tmux

# Debian or Ubuntu
sudo apt install tmux

Install

Install the CLI in an isolated environment with uv:

uv tool install runbuoy

Or use pipx:

pipx install runbuoy

The installed executable is available directly:

runbuoy doctor
runbuoy capabilities --json

New installations use https://runbuoy.cloud as the default server URL. Override it when needed with runbuoy config --server-url <url>.

Upgrade with the same tool used for installation:

uv tool upgrade runbuoy
# or
pipx upgrade runbuoy

Quick start

Pair this machine with the RunBuoy iOS app:

runbuoy pair

Run a command:

runbuoy run -- python3 experiment.py

Send a notification without starting a managed run:

runbuoy notify \
  --title "Build completed" \
  --body "Release build succeeded" \
  --level success

RunBuoy does not upload full command arguments, working directories, environment variables, source code, or complete logs by default. See the security documentation for the complete data boundary.

Source and support

Source code, documentation, and issue tracking are available in the RunBuoy repository. Maintainer packaging and release instructions are in docs/cli-distribution.md.

RunBuoy is licensed under the MIT License.