用途:在 macOS 上通过 things 命令行管理 Things 3,既能只读查询本地数据库,也能通过 Things URL scheme 新增和更新待办。
主要能力:读取收件箱、今天、即将到来、搜索、项目、领域、标签;新增待办并设置备注、时间、截止日期、所属列表/标题、标签、检查清单;更新待办标题、备注(替换/追加/前置)、移动列表、标签(替换/添加)、完成或取消。
安装:GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。若数据库读取失败,需为调用方授予完全磁盘访问权限(手动运行给 Terminal,网关运行给 Clawdbot.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;新增示例 things add "Buy milk" --notes "2% + bananas",可加 --list、--heading、--tags、--checklist-item,支持从 STDIN 读取多行(首行标题、其余为备注)。更新需先搜索取得 UUID,再执行 things update --id <UUID> --auth-token <TOKEN> 等。建议先用 things --dry-run 预览,--dry-run 只打印 URL 不打开 Things。
限制:仅支持 macOS;当前不支持删除或移入废纸篓的写入命令,things trash 仅可读取列表,删除需用 Things 界面或改为标记完成/取消。