VibeBuddy：在 Mac、iPhone 和 Apple Watch 上跟进 AI 编程 Agent

AI 编程 Agent 很适合在你离开桌面后继续执行任务，但真正有用的问题往往是它是否需要你、是否已经完成，以及下一步是否适合安全地批准。VibeBuddy 把 Mac 上的 Agent 活动放进 iPhone 收件箱，再把一小部分结果带到手腕上的 Apple Watch。

项目由 Mac 菜单栏应用、iPhone 应用和 Apple Watch 配套组成。它可以跟进 Claude Code、Codex、Grok Build，可选只读观察 Grok Bot，也能查看 Cursor 的使用量，同时让 Mac 保持本地中心。当前 Mac 版本是 v1.3.24，App Store 版本是 v1.3.23；两者都不要求 VibeBuddy 账户。

它能做什么

在 Mac 上，Inbox 会把需要你处理的任务、未读结果和正在运行的任务分开。每一行可以显示项目、Agent、模型、当前活动和使用量信息。面板支持按项目整理，也可以打开会话阅读器查看最近对话、历史记录、搜索结果和导出内容。

当某个集成暴露了受支持的请求时，iPhone 可以显示有限的命令或差异预览，让你批准、拒绝或回答。连接的 app-server 如果拥有对应的 Codex 任务，也可以继续推进它。原生提示、未支持的请求类型，以及必须在 Mac 上完成的操作，仍然留在 Mac 上。

它也覆盖任务周边的工作流：可以在交给另一个 Agent 前检查目录和交接提示，分别查看 Cursor Models 和 Other Models 的使用量，通过只读 MCP 查询本地历史，并在 iPhone 小组件和 Watch 上查看状态。

如何安装

iPhone 和 Apple Watch 配套应用使用官方 VibeBuddy App Store 页面。Mac 中心应用则下载 GitHub Release v1.3.24 或直接下载 DMG。Mac 需要 Apple Silicon 和 macOS 14 或更高版本，iPhone 需要 iOS 17 或更高版本；Watch 需要配对的 iPhone 和 watchOS 26.5 或更高版本。

# iPhone and Apple Watch companion:
open https://apps.apple.com/us/app/vibebuddy-agent-monitor/id6777469338

# Mac companion DMG:
open https://github.com/semantic-craft/iOS-vibebuddy/releases/download/v1.3.24/vibebuddy-mac-v1.3.24.dmg

# Drag the Mac app to /Applications, then pair the iPhone by QR code.

把 Mac 应用拖到 Applications 后启动，连接实际使用的 CLI，并选择 Show connection code。在 iPhone 上安装 App Store 应用，然后选择 Scan to pair。第一次设置时建议让设备处于同一个可信本地网络。实时任务和远程操作需要 Mac 保持运行并可访问。

如何使用

最适合用来测试的，是 Claude Code、Codex 或 Grok Build 中的一项短任务。让 Mac 上的 Agent 继续运行，在 iPhone 观察任务从 Working 转到完成或 Needs you。出现审批时先阅读命令或差异预览；原生提示仍需回到 Mac。

如果要使用历史记录，在 Mac 上打开 Settings → Connect，复制 Claude Code、Codex 或 Cursor 的设置片段。vibebuddy-mcp 可以对本地历史提供 sessions、projects、search、show、summary 和 status 只读查询；它不会启动 daemon、批准任务或修改库。

# Pairing loop:
# Mac: Settings → Devices & connection → Show connection code
# iPhone: Scan to pair
# Keep the Mac running and reachable for live task data.

本地连接使用带 Bearer 认证的 HTTP 和 WebSocket，但不包含内置 TLS。应使用可信 LAN 或 Tailscale 这样的私有网络，保护配对 QR 和 Token，绝不要把 9876 端口直接暴露到互联网。

# Build from source only for development:
git clone https://github.com/semantic-craft/iOS-vibebuddy.git
cd iOS-vibebuddy
xcodegen generate --spec VibeBuddyMacApp/project.yml
open VibeBuddyMacApp/VibeBuddyMacApp.xcodeproj

Mac、iPhone 和 Watch 的分工

Mac 负责阅读会话，也负责 Provider hooks、审批和原生终端边界。iPhone 是远程收件箱，显示使用量、小组件、Live Activities 和任务更新。Watch 通过 iPhone 接收快照，所以它不是直接连接 Mac 的客户端。

本地优先的边界

VibeBuddy 没有会话云、VibeBuddy 账户或分析服务。Mac 与 iPhone 使用 Bearer 认证直接通信，Watch 通过配对的 iPhone 接收快照。语音与摘要请求会直接发送给你选择的服务商，服务商的条款、保存方式和费用仍然适用。

监控和普通审批不需要 VibeBuddy AI Key，但语音和摘要需要。应用可以使用 OpenAI、Google Gemini、Alibaba Qwen 或 Volcengine Doubao；项目文字、终端输出或个人语音会离开设备发送给对应服务商，启用前应先确认处理方式。

语音、通知与使用量

语音默认关闭。启用后可以使用摘要或朗读，文字监控和按钮审批仍不需要 AI API Key。通知可以只负责提醒某个任务需要处理，不必把每一次状态更新都变成模型请求。

应用关闭时的推送需要配置 Apple Push Notification。公开下载不是开箱即用的托管推送服务；要可靠投递，就需要配置 APNs 路径并承担运维责任。应用打开时，本地更新和 Mac 连接是更简单的基础方案。

v1.3.24 带来了什么

Mac v1.3.24 改进了面板：侧边栏可以调整宽度或折叠为图标栏，会话列表与阅读器之间的分隔线可调整，搜索可以展开紧凑布局。Get Started 卡片把 CLI hooks、iPhone 下载和行内配对放在一起，语音与摘要也会等待原生完成。

它的局限

VibeBuddy 是 Claude Code、Codex、Grok、Cursor 以及运行它们的 Mac 的配套，而不是替代品。Mac 关机、睡眠或不可访问时，没有实时任务状态和远程操作。Apple Watch 也依赖配对的 iPhone，App Store 的可用性还可能因地区而异。

能力取决于集成：Grok Bot 只能只读观察，Cursor 使用量不等于 Cursor 任务控制，一些原生 Agent 提示仍需 Mac。关闭应用时推送需要额外 APNs 工作，语音依赖服务商、Key 和网络；本地 HTTP/WebSocket 也不是公开 daemon 的理由。

源码构建适合贡献者或需要自定义签名的人，不是常规安装路径。仓库要求 Xcode 26.6、Swift 6 和 XcodeGen，真机还需要签名团队、标识符和 Capabilities。应先使用 App Store 与 Mac Release，只有它们不满足需求时才构建。

许可证

VibeBuddy 使用 MIT License 发布。只要保留版权和许可证文本，就可以检查、修改、使用和再分发项目代码，包括用于商业软件。许可证不提供任何担保。

MIT 授权不会替代 Apple 平台、App Store、Claude Code、Codex、Grok、Cursor、AI 服务商、Swift 包或 Agent 凭据各自的条款。VibeBuddy 是独立项目，不隶属于这些服务商或 Apple。

适合你吗

如果你已经在 Mac 上运行 AI 编程 Agent，又希望从 iPhone 或 Watch 关注审批、完成结果和使用量，VibeBuddy 是一个定位清晰的选择。可以从 App Store 配套应用 和 Mac v1.3.24 Release DMG 开始，保持 Mac 端点私有，准备好承担 Provider Key 和通知投递后再启用语音或推送。

# iPhone and Apple Watch companion:
open https://apps.apple.com/us/app/vibebuddy-agent-monitor/id6777469338

# Mac companion DMG:
open https://github.com/semantic-craft/iOS-vibebuddy/releases/download/v1.3.24/vibebuddy-mac-v1.3.24.dmg

# Drag the Mac app to /Applications, then pair the iPhone by QR code.