things-mac

Things 3 CLI

使用 things 讀取本機 Things 資料庫（收件匣/今天/搜尋/專案/區域/標籤），並透過 Things URL scheme 新增/更新待辦事項。

設定

• 安裝（建議，Apple Silicon）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• 若資料庫讀取失敗：請授予呼叫的應用程式完整磁碟存取權限（手動執行時為終端機；閘道執行時為 OpenClaw.app）。
• 可選：設定 THINGSDB（或傳入 --db）指向你的 ThingsData-* 資料夾。
• 可選：設定 THINGS_AUTH_TOKEN，避免在更新操作時傳入 --auth-token。

唯讀（資料庫）

• things inbox --limit 50
• things today
• things upcoming
• things search "query"
• things projects / things areas / things tags

寫入（URL scheme）

• 建議先安全預覽：things --dry-run add "Title"
• 新增：things add "Title" --notes "..." --when today --deadline 2026-01-02
• 將 Things 帶到前景：things --foreground add "Title"

範例：新增待辦事項

• 基本：things add "Buy milk"
• 附註：things add "Buy milk" --notes "2% + bananas"
• 放入專案/區域：things add "Book flights" --list "Travel"
• 放入專案標題下：things add "Pack charger" --list "Travel" --heading "Before"
• 加上標籤：things add "Call dentist" --tags "health,phone"
• 檢查清單：things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
• 從 STDIN（多行 => 標題 + 註解）：
  • cat <<'EOF' | things add -
  • Title line
  • Notes line 1
  • Notes line 2
  • EOF

範例：修改待辦事項（需要驗證 token）

• 首先：取得 ID（UUID 欄位）：things search "milk" --limit 5
• 驗證：設定 THINGS_AUTH_TOKEN 或傳入 --auth-token <TOKEN>
• 標題：things update --id <UUID> --auth-token <TOKEN> "New title"
• 取代註解：things update --id <UUID> --auth-token <TOKEN> --notes "New notes"
• 附加/前置註解：things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
• 移動列表：things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"
• 取代/新增標籤：things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
• 完成/取消（類似軟刪除）：things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
• 安全預覽：things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

刪除待辦事項？

• things3-cli 目前不支援（沒有「刪除/移到垃圾桶」的寫入指令；things trash 是唯讀列表）。
• 替代方案：使用 Things 介面刪除/丟入垃圾桶，或透過 things update 標記為 --completed / --canceled。

備註

• 僅限 macOS。
• --dry-run 會印出 URL 而不開啟 Things。