Grux for Mac
在一处处理邮件、日历、会议和终端任务，并让命令执行可撤销。
- Star 数
- ★ 30
- 最近更新
- 5 天前
- License
- MIT
- 主语言
- Swift
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Claude API
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 独立开发者想在 Mac 上从一个窗口查看日历、邮件和项目任务，并让助手执行可撤销的终端命令。
- 不适合
- 需要在 Intel Mac 上运行的用户
- 需要 Windows 或 Linux 桌面应用的团队
- 源码审查
- 67/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Grux 是面向 Apple 芯片 Mac 的原生 AI 助手，主界面是可并列打开功能面板的 Command Panel。它通过 Anthropic API 或本地 Ollama 模型运行，支持邮件、日历、联系人、笔记、文档、会议录音与转写，以及项目和任务管理。终端命令通过带路径限制、拒绝规则、速率限制和审计日志的 shell 执行，并在运行前创建快照，便于撤销。会议音频使用 WhisperKit 在设备上转写，原始音频不会上传；凭据存入 macOS Keychain。它作为 macOS 应用分发，也附带可从终端驱动功能的 grux 命令行工具。
用户从 Command Panel 输入请求，Grux 可调用 116 个工具，访问本机已有的邮件、日历、联系人、笔记和文档，并打开对应功能面板。用户可以通过 Chat 使用 Anthropic 或 Ollama 模型，运行受路径允许列表和命令拒绝列表约束的 shell 命令；每条命令先快照到 shadow git repository，并写入审计日志。Meetings 可录制麦克风和系统音频，使用 WhisperKit 在设备上转录并归档文字记录。命令行可通过 grux setup 完成设置、用 grux status --json 检查配置、用 grux doctor 排查问题；外部 MCP 客户端可通过只读 MCP bridge 读取信息。
- 独立开发者想在 Mac 上从一个窗口查看日历、邮件和项目任务，并让助手执行可撤销的终端命令。
- 不想把会议录音上传的团队，需要在设备上区分说话者、转写并保存会议记录。
- 希望用本地模型处理私人资料的 Mac 用户，可通过 Ollama 运行 Grux 而不配置模型密钥。
- 使用 Anthropic API 的用户，希望在 Chat 中把邮件、联系人和文档作为工作上下文。
- 使用终端编码代理的开发者，希望通过 grux 命令行或只读 MCP bridge 检查和驱动 Grux。
如何安装或部署这个 Agent？
Grux 的预构建应用面向 macOS 14 或更高版本的 Apple 芯片 Mac。下载 DMG 后将应用拖入 Applications 并打开。也可通过 Homebrew 安装应用和命令行工具。若从源码构建，需要 Xcode 16 或更高版本。首次使用需要配置 Anthropic API 密钥，或在本机运行 Ollama 并准备模型。
如何使用这个 Agent？
下载并安装后打开 Grux，按首次设置流程选择用途、姓名和模型；权限会在首次使用相关功能时单独请求。也可在终端运行以下命令完成设置；配置模型后可检查状态或诊断问题。
这个 Agent 有哪些优点和局限？
- 邮件、日历、联系人、笔记和文档直接连接 Mac 上的真实账户，没有 Grux 后端或托管副本。
- 支持 Anthropic API 和本地 Ollama 模型；本地模型可在不提供密钥的情况下使用。
- shell 命令在执行前快照，且有路径允许列表、命令拒绝列表、速率限制和审计日志。
- 会议录音在设备上由 WhisperKit 转写，原始音频不上传。
- 随应用提供 CLI 和只读 MCP bridge，方便终端代理读取及操作 Grux。
- 仅支持 macOS 14 或更高版本及 Apple 芯片；README 明确说明 Intel Mac 不受支持。
- 使用 Anthropic 托管模型需要用户提供 API 密钥并直接承担模型费用。
- 需要分别配置模型和按功能授权 macOS 权限；邮件、会议、shell 等能力还需授予对应权限。
- MCP bridge 为只读；写入操作需通过 Grux 的 Unix socket 接口。
- 12 项 Labs 功能被标为仍较粗糙，文档特别指出 Agents 和 Self-Upgrade 尚有较多工作。
这个 Agent 与同类方案有什么区别？
README 明确列出 Raycast AI、LM Studio、Claude 桌面应用、ChatGPT 桌面应用、Osaurus、Msty 和 Jan 等对比主题。Grux 的区别在于它是可操作邮件、日历、文件与 shell 的原生 Mac agent；LM Studio 在 README 中被描述为运行模型的工具，而 Grux 是会采取操作的 agent。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Grux for Mac 当前 | 67 · 存在缺口 | 桌面应用免费 | ★ 30 | 5 天前 | Swift | Claude API |
| GAIA 个人 AI 助手 | 73 · 存在缺口 | 云服务 / SaaS免费版 + 付费版 | ★ 308 | 今天 | Python | — |
| TuriX | 34 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.2k | 28 天前 | Python | Claude.ai |
| OnlySwitch —— 一体化 macOS 菜单栏切换工具 | 54 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 6k | 2 天前 | Swift | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明权限按需申请且可拒绝，并描述了文件路径白名单、拒绝名单、限额、脱敏和审计日志；同时承认应用未沙盒化，shell可执行真实命令，权限面较大，因此最小权限、确认和回滚仅评为2。数据流说明具体到Keychain、模型服务商、会议音频和本地日志，评为3。依赖仅列出直接依赖，未提供本次审查可核验的漏洞状态，依赖安全评为1。安全报告渠道和维护者邮箱明确，但发布者身份未验证，来源归属评为1。
README、CI配置和启动器测试对工具数、测试门槛、失败分支及已知CI限制有具体描述，整体自洽但部分产品说法无法由所给文件独立确认，评为2。依赖版本和最低工具链有说明，但没有可用性或兼容性证据，评为2。CLI提供status、doctor、why及退出码信息，测试也覆盖若干错误提示；尚不能证明所有失败都能清楚恢复，评为2。
目标环境明确为Apple silicon、macOS 14以上，并列出本地Ollama和托管模型等场景；功能广泛，但各类使用者与场景的适配说明有限，评为2。权限表、功能分层及安全边界说明了能力范围，也承认未沙盒化和Labs较粗糙，评为2。工具按需请求权限且拒绝后仅禁用对应功能，表明触发条件有一定精度，但其他高影响操作的确认细节不完整，评为2。平台、工具链和模型选择说明具体，但仅覆盖Mac环境，评为2。
README有目录、安装、权限、功能分层和构建说明，结构较完整；内容很长且所给README在后段截断，信息架构评为2。DMG、Homebrew、CLI、校验和及源码构建步骤明确，安装说明评为3。产品版本和功能名有说明，但未提供完整命名规则，评为2。FAQ链接和命令示例丰富，但所给材料不能核验外部问答内容，评为2。安全文档列出URL重定向、DNS和脱敏器等已知限制，README也标出Labs边缘粗糙，评为2。MIT许可证文本完整，评为3。README称当前3.0，CI和安全政策涉及发布支持，但所给材料缺少完整变更历史，评为2。安全邮箱、漏洞响应时限及支持版本政策有说明；个人项目且身份未验证，维护责任虽有交代但有限，评为2。
命令行可输出JSON，提供status、doctor、why，测试覆盖启动器透传与终端输出；实际任务结果未经运行验证，评为2。统一界面、系统集成和可复用Swift模块体现潜在增值，但广泛权限与复杂功能也带来成本，评为2。MIT、本地模型选项和无订阅降低使用成本；托管模型需用户付费，且硬件、权限和设置要求较高，评为2。
不少安装、安全和功能主张对应具体文件、配置或测试描述，但部分重要主张仍是README自述，评为2。README、CI、安全政策和启动器测试彼此支持部分主张；未提供运行结果或全部实现文件，评为2。文档明确区分核心与Labs，并承认若干限制；事实、承诺和推断仍未处处标明，评为2。
- 应用未启用macOS沙盒，且可接触邮件、日历、屏幕和shell；使用前应阅读权限说明与SECURITY.md，并只授予所需权限。
- 托管模型提供商会接收发送给它的内容；本地模型可减少这一数据流，但仍需确认本机配置与权限。
- 材料中CI评论提到曾有四个“never-publish”值从公开副本中恢复，但未说明这些值的性质或当前状态；静态材料不足以判断其影响。