用途：在 macOS 上用 things 命令行读写 Things 3。读取操作直接访问本地数据库，写入操作通过 Things URL scheme 完成，可添加到收件箱、今日、项目或区域，并支持备注、截止日期、标签和清单项。
主要能力：读取侧支持 things inbox、things today、things upcoming、things search、things projects、things areas、things tags，可用 --limit 限制数量。写入侧支持添加待办，示例：things add "Buy milk" --notes "2% + bananas"；--list 指定项目或区域，--heading 指定项目标题，--tags 添加标签，--checklist-item 添加清单项，--when 与 --deadline 设置时间。也可从 STDIN 传入多行内容，首行为标题、其余为备注。更新需先取得 UUID（things search 返回 UUID 列），再执行 things update --id <UUID> --auth-token <TOKEN>，可改标题、替换或追加/前置备注、移动列表、替换或追加标签、标记完成或取消。
使用方式：安装命令为 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。写入前建议先用 --dry-run 预览，该模式只打印 URL 不打开 Things。
限制：仅支持 macOS。当前不支持删除或移入废纸篓的写入命令，things trash 只提供只读列表；删除需在 Things 界面操作，或改用 --completed / --canceled 标记。更新操作需要授权令牌。