things-mac

Things-mac 是一款專為 OpenClaw 個人 AI 助理設計的整合工具，為您的 Things 3 資料庫提供功能完整的命令列控制。它專為 macOS 開發，填補了 AI 助理與您的主要任務管理系統之間的鴻溝。透過直接與本地 Things 3 資料庫互動並利用 Things URL 架構，此技能讓使用者能完全透過自然語言或自動化觸發來維持結構化的任務工作流程。無論您是要查詢收件匣、排定今日優先事項，或是將新項目加入特定專案與領域，此工具都能作為可靠的介面，確保任務同步順暢。

• 執行完整的讀取操作，包括檢索收件匣、今日議程、即將到來的截止日期，以及搜尋所有任務、專案、領域與標籤。

• 執行寫入操作，例如新增含有備註、截止日期、排程日期與專案指派等中繼資料的待辦事項。

• 透過修改標題、備註、標籤，或是在列表與標題之間移動任務來更新現有項目。

• 支援進階任務結構，包括建立檢查清單項目，以及透過標準輸入 (STDIN) 處理多行備註。

• 整合 Things 3 URL 架構，可將應用程式切換至前景，並執行試運行 (dry-run) 以安全驗證指令。

• 高度配置彈性，支援自訂資料庫路徑與驗證代幣 (auth token)，確保更新過程安全可靠。

• 請確保呼叫此工具的應用程式 (如 Terminal 或 OpenClaw) 已在 macOS 系統設定中取得「完全磁碟存取權」，以便讀取本地 Things 資料庫。

• 雖然讀取操作是透過存取本地資料庫完成，但寫入操作需使用 Things URL 架構，且建議設定驗證代幣以進行安全修改。

• 請注意，此工具不支援直接刪除等破壞性動作；使用者應透過將項目標記為已完成或已取消來處理。

• 此工具僅限於安裝有 Things 3 的 macOS 環境中使用。

• 在初始設定或測試期間，建議使用 --dry-run 旗標來預覽指令，而不會對您的即時任務資料庫造成影響。