用途：在 macOS 上通过 things CLI 管理 Things 3，可读取本地 Things 数据库（收件箱、今天、即将到来、搜索、项目、区域、标签），也可通过 Things URL scheme 添加或更新待办。
安装（推荐，Apple Silicon）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。若读取数据库失败，需为调用方授予完全磁盘访问权限（手动运行用 Terminal，网关运行用 OpenClaw.app）。可选设置 THINGSDB 或传 --db 指向 ThingsData-* 文件夹；更新操作可设 THINGS_AUTH_TOKEN 免去 --auth-token。
读取：things inbox --limit 50、things today、things upcoming、things search "query"、things projects / areas / tags。
写入：建议先用安全预览 things --dry-run add "Title"；添加示例 things add "Title" --notes "..." --when today --deadline 2026-01-02；加 --foreground 可置前 Things。支持 --list 指定项目/区域、--heading 指定标题、--tags 添加标签、--checklist-item 建清单，也支持从 STDIN 读取（首行标题、后续为备注）。
更新（需 auth token）：先 things search "milk" --limit 5 获取 UUID，再 things update --id <UUID> --auth-token <TOKEN> 修改标题、备注（--notes/--append-notes/--prepend-notes）、列表、标签（--tags/--add-tags），或用 --completed/--canceled 完成或取消；同样支持 --dry-run。
限制：仅支持 macOS；当前 things3-cli 不支持删除/移入回收站（回收站仅可读），需在 Things UI 删除或改用完成/取消标记。--dry-run 只打印 URL，不会打开 Things。