Adrafinil：AI 编程时保持 Mac 唤醒

项目简介

Adrafinil 是一款 macOS 菜单栏应用：只有当 AI 编程 agent 实际工作时，它才让 Mac 保持唤醒——即使合上盖子也继续运行；一个回合结束后，它立刻释放唤醒锁。它通过 hooks 跟踪各个 agent 的活动，并用温度保护（thermal cutout）和弃置会话自动释放机制，来约束无人值守的长时运行。

主要功能

• 合盖保持运行：agent 工作期间关闭盖子，Mac 继续工作。
• 多个 agent 重叠工作时分别独立跟踪，最后一个 hold 结束后才恢复睡眠。
• 为 Claude Code、Codex、Cursor、Gemini CLI、Devin、Aider、Hermes、OpenCode、Cline、Pi 提供 hooks。
• 按会话 acquire/release、定时保持，以及手动 "Let it sleep" 控制。
• 通过特权 helper 控制合盖睡眠行为。
• 提供 CLI 与 MCP 访问；也可以通过 hooks 或命令包装器做自定义集成。
• 具备温度保护与弃置 hold 自动释放。
• 可选功能：检测正在运行的 agent 进程、合盖时播放音频确认、开盖后显示活动与温度摘要。
• 卸载时自动移除已安装的 hook。

安装与使用

要求 macOS 26.4+，特权 helper 需要管理员授权。macOS 15 另有 backport 版本。

使用 Homebrew 安装：

brew install --cask adrafinil

安装后打开「设置」，在其中安装所需的 agent hooks。CLI 用法、自定义 hooks 与安装细节见仓库的 REFERENCE.md。

注意事项

• 需要 macOS 26.4+，并为特权 helper 授予管理员权限。
• 关于统计：除非你主动同意，否则不会发送任何数据。菜单会询问一次，你也可以在 Settings › General 中查看并修改选择。如果你同意参与，Adrafinil 会在你使用它的每一天发送一次匿名 check-in，内容包括：Adrafinil 自身的版本与 macOS 版本、芯片系列与内存大小、语言与日期、最近 7 天中使用过几天、这台 Mac 是否有盖子，以及上周它保持唤醒过多少种 agent。它不会包含你运行了哪些 agent、你在做什么工作，也不会包含任何能指向你个人身份的信息。关闭统计会删除这台 Mac 已发送的全部数据。

本作品整理自 GitHub 开源项目 kageroumado/adrafinil，原作者 @kageroumado，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。