用途：在 macOS 上通过 things CLI 读写 Things 3 数据。本地数据库用于读取，URL scheme 用于写入。
主要能力：读取收件箱（things inbox --limit 50）、今天（things today）、即将到来（things upcoming）、搜索（things search "query"）、项目/领域/标签（things projects / things areas / things tags）。写入支持新增待办（标题、备注、时间、截止日期、所属列表/标题、标签、检查清单项），以及更新待办（改标题、替换/追加/前置备注、移动列表与标题、替换或追加标签、完成或取消）。
使用方式：安装（推荐 Apple Silicon）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。若数据库读取失败，需为调用应用授予完全磁盘访问权限（手动运行一般为终端，网关运行则为其所在 App）。可选设置 THINGSDB（或传 --db）指向 ThingsData-* 文件夹；可选设置 THINGS_AUTH_TOKEN 以免每次更新操作都传 --auth-token。新增可用 --dry-run 安全预览，--foreground 可将 Things 带到前台。示例：things add "Buy milk" --notes "2% + bananas"；things add "Book flights" --list "Travel"；更新前先用 things search 获取 UUID，再执行 things update --id <UUID> --auth-token <TOKEN> --completed。
适用场景：命令行或自动化流程中批量录入、检索与调整 Things 3 任务，供智能体工具调用。
限制：仅支持 macOS。更新操作需要 auth token。当前不支持删除或移入回收站，things trash 仅用于读取；如需删除请使用 Things 界面，或将任务标记为完成/取消。--dry-run 只打印 URL，不会打开 Things。