beluga - 为每个项目配备独立 agent 的桌面工作台

beluga 是一款面向开发者的桌面应用，据项目自述，它的核心思路是「为每个项目、以及在其中工作的每个 agent 提供一个桌面」。具体做法是：用户描述一个任务，应用就为该任务创建一个独立的 worktree、分支和 agent，多个任务可以同时运行，主目录保持不被改动。它适合需要同时推进多条工作线、又希望随时看到 agent 每一步动作的开发者，也适合想把 agent 跑在常开服务器上、再从手机或浏览器接入的人。

维护者与状态

该项目由 kayraucklnc 维护，仓库创建于 2026-10-16，最后一次提交时间为 2026-11-10。最新 release 为 v3.1.0-mac，发布于 2026-11-10。截至 2026-11-10，仓库星标数为 488。从时间线看，这是一个创建不足一个月、但已经发布到 3.x 版本号的项目，迭代节奏较快。

主要能力

以下能力均来自项目 README 的自述，未经独立验证：

• 多任务并行：每个任务拥有自己的 worktree、分支和 agent，按任务命名；侧边栏显示谁在工作、哪些改动可以合并、哪些需要用户介入。改动、diff、文件与终端位于对话旁边，可一键提交、发起 pull request 或合并。
• 过程可见：agent 工作时，读取的文件、执行的命令、启动的子 agent 与后台任务会实时呈现，用户可以在运行中途插话改变方向。README 还提到一个 Scratch 标签页，用于展示 agent 过程中产生的截图、测试日志、API 返回的 JSON 等文件，并称该目录不进入 git。
• 结构化回答：据项目说明，询问数据时 agent 会找到数据库、连接并执行查询，结果以可排序、可搜索、可转成图表的实时表格呈现；询问代码结构时会绘制关系图；询问剩余事项时任务以卡片形式出现。README 列出的图表类型包括折线、面积、柱状、饼图、散点、甘特、热力图与日历。
• 朋友之间的 agent 互通：用户 @ 一位朋友并说明需求，自己的 agent 会请求对方的 agent 在对方的机器上执行，对方点击 Allow 后结果回到对话中。README 称每个 agent 都运行在所有者自己的机器上、使用所有者自己的订阅与登录，机器之间点对点直连并端到端加密，中间不经过服务器；并称 .env 文件与密钥不会被共享，返回结果作为数据使用而非作为指令执行。
• Sentinel 定时与事件任务：用一句话描述的工作，可以在固定时间、手动触发、在另一个 sentinel 之后，或由 GitHub、Stripe、Sentry、站点失联、webhook 等事件触发，执行后留下报告。README 称新建 sentinel 默认处于暂停状态，合并始终需要检查通过并由用户确认。
• 远程与多机：应用本身留在 Mac 上，实际工作可以跑在用户指定的另一台机器上，例如 Mac mini、AWS 或 Azure 服务器、Linux 机器；README 描述通过 SSH 添加计算机后应用会自行安装并启动，也提供 beluga pair --computer 的配对方式。此外还提到手机应用可查看 Mac 上 beluga 的运行情况并处理待办。
• 其他附带功能：README 还列出收益面板（连接 Stripe、RevenueCat）、归档、活动与用量查看、深浅色主题、⌘K 命令面板、⌘J 终端抽屉、菜单栏图标与自动更新等。

使用入口

项目仓库地址为 kayraucklnc/beluga，安装包与详细说明以仓库发布内容为准。

据 README 的安装说明，各平台流程大致如下：

• macOS：打开 .dmg 并把 Beluga 拖入 Applications。首次打开时系统会拦截，因为应用尚未经过 Apple 公证，需要点击 Done，再到「系统设置 › 隐私与安全性」中点击「仍要打开」。若旧版本提示应用「已损坏」，README 给出的处理方式是在终端执行一次以下命令后重新打开：

xattr -dr com.apple.quarantine /Applications/Beluga.app

• Windows：运行 Beluga_…_x64-setup.exe；若系统提示已保护电脑，点击「更多信息 › 仍要运行」，README 说明安装包尚未签名。此外需要安装 Git for Windows，README 称 Claude Code 依赖它。
• Linux：将 .AppImage 设为可执行后打开，或安装 .deb / .rpm。
• 前置条件：README 要求先登录 Claude Code（运行 claude 后执行 /login），其余由 beluga 提供。若要与朋友协作，需在 Friends 中开启并添加好友、发送代码。

许可与限制

项目采用 MIT 许可证。

README 中明确写出的限制与边界包括：

• 平台要求为 macOS 13 及以上（Apple Silicon）、Linux x64（AppImage、.deb、.rpm）、Windows 10 及以上 x64。
• macOS 版本尚未经过 Apple 公证，Windows 安装包尚未签名，因此首次安装需要手动绕过系统拦截。
• Windows 上需要额外安装 Git for Windows。
• 使用前需要已有 Claude Code 账号并完成登录；朋友之间的 agent 调用依赖对方在其机器上点击允许。
• 远程执行依赖能够通过 SSH 访问目标机器，或使用配对命令完成连接。

需要说明的是，上述能力描述、平台支持与安全机制均来自项目自述，本文未对应用进行实际运行验证；涉及数据、费用与隐私的功能，建议在使用前自行核对仓库中的最新文档与实现。