帮助

用 Homebrew：

brew install zysuccess/tap/rudder
rudder

rudder 在终端里运行，并显示配对二维码。想让它在后台常驻、开机自动启动：

rudder install

agent 本身（Claude Code、Codex 等）照常在 Mac 上安装并登录。

打开 Rudder，扫终端里的二维码。每个码只能用一次，几分钟后失效。随时要新码：

rudder pair

要加一台电脑：在那台电脑上装 rudder 并扫它的码；会话列表顶部的电脑胶囊可以切换。

Claude Code、Codex、Grok、GitHub Copilot、Cursor、opencode、Kimi、pi，以 Mac 上装了哪些为准。Rudder 会列出找到的 agent，以及哪个不可用、为什么。

1. 电脑别睡着，rudder 要在运行。在电脑终端里看一眼：rudder status
2. 在家：手机和电脑连同一个 Wi‑Fi，设置 › 权限 › 本地网络 是「已允许」。
3. 在外面：两边登录同一个 Tailscale（见下一条）。
4. 还不行，在电脑上跑 rudder pair，重新扫码配对。

1. 在 Mac 和 iPhone 上都装 Tailscale，登录同一个账号，保持 MagicDNS 打开。
2. 在 Mac 上跑 rudder pair，扫新码。rudder 几分钟内会发现 Tailscale，重启一下 rudder 则立即生效。
3. 之后 App 在家先走局域网，出门自动走 Tailscale。

• iOS 设置 › Rudder › 通知 要打开，专注模式要允许 Rudder。
• 通知是电脑发的，所以 rudder 要在运行并且联网。
• 更新 App 后打开一次，让它重新登记。

项目放在 文稿、桌面 或 下载 里就点允许，否则 agent 没法在那里干活。之后可在 系统设置 › 隐私与安全性 › 文件与文件夹 里修改。

在 Mac 上列出已配对的手机，撤销不再用的那台：

rudder devices
rudder devices revoke "iPhone 15"   # 写名字，或列表里的 id

它会立刻断开，密钥随即删除，只有重新扫新码才能再连上。rudder 在不在运行都能用。只跑 rudder uninstall 不会清掉已配对的手机：先撤销，或者用 --purge。

~/Library/Logs/Rudder/com.zysuccess.rudderd.out.log 和 .err.log；rudder status 会打印路径。

rudder uninstall          # 停止并移除开机启动
rudder uninstall --purge  # 连数据和日志一起删（手机要重新配对）
brew uninstall rudder