安装 CLI

RunBuoy CLI 发布在 PyPI，支持 macOS 和 Linux，需要 Python 3.12 或更新版本。

使用 uv

uv tool install runbuoy
runbuoy doctor

如果终端还找不到 runbuoy：

uv tool update-shell

升级或卸载：

uv tool upgrade runbuoy
uv tool uninstall runbuoy

pipx install runbuoy
runbuoy doctor

如果终端还找不到 runbuoy：

pipx ensurepath

升级或卸载：

pipx upgrade runbuoy
pipx uninstall runbuoy

uv tool install 'runbuoy==0.1.2'
# 或
pipx install 'runbuoy==0.1.2'

持久 Run 依赖系统提供的 tmux：

# macOS
brew install tmux

# Debian / Ubuntu
sudo apt install tmux

Python 包管理器不会安装这个系统依赖。

显式选择当前使用的 shell：

runbuoy completion install zsh
# 或
runbuoy completion install bash
runbuoy completion install fish

重启终端后，命令、选项、合法枚举值和本地 Run ID 均可补全。status 与 logs 会补全全部本地 Run，attach 与 cancel 只补全仍在运行的 Run。