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 指令，可驗證安裝、認證與代理設定。