用途:在 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
读取示例:things inbox --limit 50;things today;things upcoming;things search "query";things projects / things areas / things tags。
写入示例:things --dry-run add "Title";things add "Title" --notes "..." --when today --deadline 2026-01-02;things add "Book flights" --list "Travel";things add "Call dentist" --tags "health,phone";也可从 STDIN 传入多行内容(首行为标题,其余为备注)。
更新需认证:设置 THINGS_AUTH_TOKEN 或传 --auth-token <TOKEN>,先用 things search 获取 UUID,再执行 things update --id <UUID> --auth-token <TOKEN> ...。
限制:仅 macOS;若数据库读取失败,需为调用方(手动运行用 Terminal,网关运行用 OpenClaw.app)授予完全磁盘访问权限;可用 THINGSDB 或 --db 指定 ThingsData-* 目录;当前不支持删除或移入废纸篓的写入命令,things trash 仅可列出,删除需在 Things 界面操作或改用 --completed / --canceled;--dry-run 只打印 URL,不会打开 Things。