omnifocus

OmniFocus Manager 是一款專為進階使用者設計的技能，旨在將任務管理流程直接整合至終端機或 Claude 互動環境中。它提供強大的介面來與 OmniFocus 專案及任務互動，縮減手動輸入與自動化資料處理之間的差距。此工具非常適合開發人員、專案經理以及任何依賴 OmniFocus 進行 GTD（待辦事項管理）的使用者，幫助透過程式化方式操控任務清單，從而減少切換操作情境的負擔。

• 智慧型方法偵測會自動選擇最有效率的執行路徑，涵蓋 Omni Automation (JavaScript API)、AppleScript 或 SQLite 唯讀備援模式，確保在所有版本的 OmniFocus 上皆能保持高度相容性。

• 全方位的任務生命週期管理功能，允許使用者建立包含中繼資料的新任務、透過標籤或專案名稱等篩選條件查詢現有任務，以及執行如「標記任務為完成」等狀態更新操作。

• 原生專案列出功能可提取關於目前專案的結構化 JSON 資料，包含任務數量與狀態指標，有助於提升資料的可見度與洞察力。

• 強大的指令列整合能力支援常見 Shell 操作，讓使用者能夠串接任務、將輸出導向至如 jq 等工具進行進一步處理，並將 OmniFocus 資料整合至更大型的報告或分析流程中。

• 靈活的參數支援功能可處理任務標題、註記、ISO 8601 格式的截止日期以及複雜的標籤結構，以維護高品質的任務資料。

• 在建立任務前務必先查詢精確的專案名稱，因為專案名稱可能包含特殊字元或資料夾字首；建議優先使用 --list-projects 指令進行驗證。

• 執行更新時，請先透過 --read 指令取得特定的任務 ID，以確保操作精確度。

• 對於名稱複雜的專案，建議使用 AppleScript 作為備援方式；若無法取得自動化權限，則可使用 SQLite 唯讀模式進行資料查詢。

• 完整寫入功能需要作業系統層級的自動化存取權限（請檢查隱私權與安全性設定）；若遇到存取錯誤，請參閱本地設定說明。

• 本工具針對 JSON 輸出進行最佳化，非常適合用於程式化解析並整合進自訂腳本中。