Atticus用本地快捷流程加速桌面任务

按住 ⌃ control ⌥ option space，说出你的需求，然后松开。Atticus 会移动窗口、查找文件、读取屏幕，帮你把事情办好。

⚡ 快速 · 🔑 无需 API key · 🧠 记得你 · 免费开源

快速。简单的请求会跳过 AI：打开一个 app 只需 0.08 秒。让它执行一次操作，Atticus 就能学会，下次眨眼间就能完成，不用 AI，也不花钱。

无需 API key。它通过 Claude Code，使用你已有的 Claude Pro 或 Max 套餐运行。不用注册新账号，不用粘贴 key，也没有额外账单。

记得你。只要说“记住……”，之后的每次请求都会带上这条记忆。它会逐渐了解你是谁，比如你的名字、你用的 app；你纠正它时，它也会改正自己的错误。

用的是 Windows？@FindlayHi 为 Windows 开发了 Atticus，集成了 Home Assistant、Jellyfin、Immich 等服务。

在 Settings → General → Shortcut behavior 中选择 Hold to talk（按住说话）或 Press to toggle（按下切换）。按住模式会在松开时发送。切换模式第一次按下开始录音，第二次按下发送；说话时停顿也会继续监听。Atticus 正在回答时，按快捷键会停止回答；正在播放语音时，则会停止语音。Esc 会取消监听，不发送内容。切换模式下，录音达到 60 秒后会进入确认界面，不会自动发送。关闭浮层或暂停 Atticus，会停止麦克风、后台 worker 和语音。

点击任意回答即可复制，包括框里仍然显示的历史回答。点击你的请求可以编辑后重新提问，也可以在空的输入框中按 ↑，调出最近一次请求。调整大小时，浮层会始终保持在显示器范围内，并遵循 Reduce Motion 设置。当 Atticus 在被遮挡的窗口、另一个 Space 或另一台显示器上操作时，一个实时小预览会显示那个窗口，下方的步骤会展示正在执行的操作。任务完成后的画面会一直保留，直到你提出下一个请求、开始输入，或点击画面。点击它，就能打开对应的那个窗口。预览始终留在你的 Mac 上，绝不会发送给 AI，也不会保存；任务结束时会停止实时传输。如果没有 Screen Recording 权限，同一张卡片会显示 app 图标和窗口标题。

在 AI 工具或已学会的快捷操作执行前，Apple 的最终转写结果会确认每条语音请求。AI 可以在你停顿时开始推理，但工具会等到确认后才执行。如果语音转写迟迟无法完成，Atticus 会提供已有的部分文本，让你检查。即时命令仍然完全跳过 AI。在 Settings → Intelligence 中开启 Instant commands 和 Act while I’m talking 后，受支持的内置命令可以在你说话途中、发送之前执行。已学会的快捷操作会等待语音文本确认后再执行。

在 Settings → Meetings → Meeting Copilot settings 中启用 Meeting Copilot，然后在通话时打开它，或试试 demo。在任何状态下，都可以拖动它的标题栏或空白背景；最小化后的胶囊也能拖动。位置和展开后的尺寸会按显示器分别记住。双击标题栏可回到默认位置。窗口会始终保持在显示器的可用区域内，切换显示器后也是如此。

Save meeting transcripts 默认开启。监听期间，一个不显眼的指示标记会显示保存是否正在进行。文本、说话人标签、时间戳、笔记和 Copilot 回答会逐步保存到 $ATTICUS_DIR/meetings/<meeting-id>/ 下，通常是 ~/.config/atticus/meetings/。每个文件夹都是私有的，权限为 0700，其中包含 metadata.json 和只追加写入的 events.jsonl，文件权限为 0600。尚未完成的语音每两秒保存一次检查点，因此中断的通话记录仍然可读。音频从不保存。

通过 Settings → Meetings，或通话结束后的 See all meetings，可以打开本地归档。你可以搜索标题和转写文本，用 ↑/↓ 和 Return 浏览，按 ⌘F 搜索，按 Esc 返回。每场会议都会显示回顾、待办事项、笔记、回答和带时间戳的转写文本。可以复制、导出 Markdown，或确认后删除。关闭保存功能会停止当前会议的归档，并询问你要保留还是删除过去的会议。

开启 AI meeting summaries 时，这是默认设置，Claude 会在每次会话结束后读取一次转写文本，生成摘要和待办事项，使用的是你自己的 Claude 套餐。关闭它，转写文本就会完全留在你的 Mac 上；你仍会得到一份更简单的本地回顾，其中会引用会议决策以及开场、结束时的发言。即使 AI 回顾生成失败，本地转写文本也会完整保留。恢复会议会取消尚未完成的回顾生成，下一次点击 End 时，会对完整转写文本生成摘要。关闭或暂停会停止回顾生成；已经保存的文本仍留在你的 Mac 上。询问 Atticus 过去的会议时，它可以用 --meeting-history "<keywords, weekday or YYYY-MM-DD>" 搜索归档。实时问答仍遵循你选定的 Meeting Copilot 回答策略。

选择菜单栏中的 Report Feedback…、Settings 中的 Report feedback，或说出、输入“report feedback”或“report a bug”。在打开 GitHub issue 草稿前，你可以检查将要提交的完整文本。内容包含一个简短模板、版本和 commit、macOS 及 Mac 型号、所用模型、safe mode 和输入设置。Include my last ask 默认关闭；回答、屏幕内容和命令日志绝不会附上。你需要自行在 GitHub 上提交草稿。

macOS 26 或更高版本，Atticus 使用 Apple 新推出的设备端语音功能。

付费 Claude 套餐，Pro 或 Max，以及 Claude Code。还没安装 Claude Code？设置窗口会帮你安装并登录。

Apple 命令行工具：xcode-select --install

Accessibility 权限支持原生点击、滚动、菜单操作、按键、拖动和向输入字段键入文本。

将下面的命令粘贴到 Terminal：

curl -fsSL https://raw.githubusercontent.com/SaarthurR/atticus-mac/main/install.sh | bash

它会检查你的 Mac，将 Atticus 下载到 ~/.atticus，构建 ~/Applications/Atticus.app，然后打开它。之后，Atticus 会在登录时启动，并自动更新；可以在 Settings → About & Updates 中关闭。

如果你要修改代码，则可以把仓库 clone 到任意位置，每次修改后运行 ./build.sh。

首次启动会打开设置窗口。它会检查你的 Claude 套餐，然后逐项请求 macOS 权限。完成后，Atticus 会驻留在菜单栏。通过 Spotlight 打开它，按 ⌘Space 并输入“Atticus”，即可进入 Settings，配置快捷键、声音、模型、速度、屏幕、记忆和用量。如果之后退出 Claude 登录，设置窗口会自动重新出现。要手动再次显示它，运行 defaults delete com.atticus.app onboarded，然后重启 app。

测试：在 macOS 上运行 python3 atticus.py --selftest，并运行 python3 -m unittest discover -s tests -v 进行离线回归测试。构建后，~/Applications/Atticus.app/Contents/MacOS/Atticus --selftest 可以检查原生转写匹配，无需打开 app。如果安装了 Node，还会检查内嵌 JavaScript 的语法。进行 UI 交互检查时，在仓库目录中运行 python3 -m http.server 8765 --bind 127.0.0.1，然后打开 http://127.0.0.1:8765/tests/ui.html；它使用模拟的原生 bridge，不会执行任何 Mac 操作，也不会调用 AI。

卸载：运行 launchctl bootout gui/$(id -u)/com.atticus.app，然后删除 ~/Applications/Atticus.app、~/.atticus、~/.config/atticus，这里存放你的设置和历史记录，以及 ~/Library/LaunchAgents/com.atticus.app.plist。

说“Codex 完成后告诉我”或“盯着这个页面，直到它显示 shipped”。Atticus 只需设置一次，之后每 5 秒在你的 Mac 上检查一次，不用 AI，所以等待不花钱。条件触发时，你会收到通知；如果你要求了后续操作，它也会执行。被监控的窗口必须保持在当前桌面上打开，被遮挡也没关系。Codex 这类 coding Agent 则通过自身日志监控，完全不需要屏幕。说“停止监控”即可取消。

Atticus 必须保持快速，而且几乎不花钱，所以新功能必须满足以下限制：

即时命令：不用 AI，费用为 $0。

AI 请求：最近 50 次请求的费用中位数低于 $0.002，耗时中位数低于 6 秒。2026 年 10 月 10 日的数据为 $0.00095、5.0 秒。运行 python3 atticus.py --budget 检查。

System prompt：开启全部选项后，仍须少于 10,000 个字符。每次请求都会为这部分付费，并且有测试强制检查这一限制。

任何需要等待或在后台运行的功能：等待期间费用为 $0。只在设置任务和最后执行操作时使用 AI。

Atticus 每天会向 PostHog 发送一次随机 ID，这个 ID 在你的 Mac 上生成，不与你的身份关联，让我能知道有多少人在使用它。它绝不会发送你的姓名、请求或屏幕内容。可以在 Settings → Account & Access → Count me as a user 中关闭。

如果你同意开启 Help improve Atticus，这项设置只询问一次，在你同意前始终关闭，那么任务失败时，会以同一个随机 ID 发送你的请求、Atticus 执行的步骤，以及失败原因。发送前，会先在你的 Mac 上移除电子邮箱、数字、文件路径、链接细节，以及代你输入的任何内容。可以在 Settings → Account & Access → Help improve Atticus 中关闭。

Atticus.swift：app 本身，包括快捷键、语音、浮层和首次设置窗口。

atticus.py：大脑，包括快速命令、system prompt，以及窗口、网页和屏幕相关的辅助功能。

ui/ui.html、ui/onboarding.html、ui/settings.html：分别对应浮层、欢迎流程和 Settings。

ui/AppIcon.icns：app 图标。

ui/orbs.js：思考光球引擎，采用 MIT 许可证，作者为 Jakub Antalik。

MIT 许可证，参见 LICENSE。ui/orbs.js 来自 thinking-orbs，同样采用 MIT 许可证。

运行回归测试时，使用临时的 ATTICUS_DIR，并用 tests/ui.html 和 tests/settings.html 进行模拟 bridge 的 UI 检查。不要把个人 Agent 设置、凭据和运行时状态提交到仓库。匿名使用情况遥测使用一个公开的 PostHog capture token。设置 ATTICUS_POSTHOG_KEY 可以覆盖它，设为空值则会禁用遥测；也可以在 Settings 中关闭 Count me as a user。

操作能力：部分思路和逻辑改编自 Plip，仓库为 github.com/hussainn7/plip-oss，采用 MIT 许可证。