basecamp/hey-cli

解决的问题

该项目为 HEY 邮件和日历服务提供命令行界面（CLI）和终端用户界面（TUI）。用户无需离开终端即可管理其通信和日程安排，更重要的是，它使 AI 编码代理能够通过标准化接口与用户的邮件和日历数据进行交互。

工作原理

该工具使用 Go 编写，并直接集成 HEY 服务。它提供两种主要操作模式：

1. TUI 模式：一个可视化终端应用程序，提供对邮件、联系人、日历和日记的访问，使用 HEY 自身的键盘快捷键。
2. CLI 模式：一组用于读取线程、回复邮件、撰写消息、搜索和管理事件的命令。它可输出人类可读格式或 JSON 格式，以便管道传输到其他工具。
3. 代理集成：包含一个设置向导，用于连接 AI 编码代理（如 Claude Code 和 Codex），并作为 MCP（模型上下文协议）服务器，将用户的 HEY 账户作为一组工具提供给 AI 代理。

适用人群

• 偏好在终端中工作，且希望避免在 IDE 与邮件/日历之间切换的 开发者。
• 希望赋予其编码代理读写邮件和管理日历事件能力的 AI 代理用户。

主要亮点

• 代理就绪：内置对 Claude Code、Codex 和 MCP 服务器功能的支持，赋能 AI 代理。
• 实时同步：与 HEY 邮件服务实时同步（例如，在手机应用中归档线程后，TUI 中也会立即反映）。
• 灵活输出：支持 JSON 输出和内置 --jq 过滤，便于脚本编写和自动化。
• getline 自有工具：提供针对 imbox、screener 等 HEY 特有功能的专用命令。
• 诊断工具：包含 hey doctor 命令，用于验证安装、认证和代理设置。