用途：在 macOS 上通过命令行操作 Things 3，既可读取本地 Things 数据库，也可添加或更新待办事项。
主要能力：读取类的 inbox、today、upcoming、search、projects、areas、tags 均为数据库只读查询，例如 things inbox --limit 50。写入类通过 Things URL scheme 完成，支持添加待办（标题、备注、时间、截止日期、项目/领域、标题分组、标签、清单项），以及按 UUID 更新标题、备注（替换/追加/前置）、移动列表、替换或追加标签、标记完成或取消。支持从 STDIN 传入多行内容（首行为标题，其余为备注）。
安装与配置：推荐 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 add "Buy milk"，或带备注、列表、标签、清单项；更新前先用 things search "milk" --limit 5 获取 UUID。建议先用 things --dry-run 预览，该模式只打印 URL、不打开 Things。
限制：仅支持 macOS。当前 things3-cli 不支持删除或移入回收站，things trash 仅为只读列表；如需删除请使用 Things 界面，或用 --completed / --canceled 标记。更新操作需要授权令牌。其余细节暂未提供。