用途:在 macOS 上通过 things 命令行读取本地 Things 3 数据库,并用 Things URL scheme 添加、更新待办事项与项目,适用于用户要求查看、搜索或修改 Things 中任务的场景。
主要能力:读取侧支持查看 inbox、today、upcoming、search、projects、areas、tags;写入侧支持添加待办,可指定备注、时间、截止日期、所属列表与标题、标签、检查清单项;支持修改标题、笔记替换或追加/前置、移动列表、替换或追加标签、标记完成或取消。
使用方式:安装推荐 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 --dry-run add "Title" 做安全预览;things add "Title" --notes "..." --when today --deadline 2026-01-02;也支持从 STDIN 传入多行(首行标题、其余为笔记)。修改需认证令牌,可设置 THINGS_AUTH_TOKEN 或传入 --auth-token,先通过 things search "milk" --limit 5 获取 UUID,再执行 things update --id <UUID> --auth-token <TOKEN> ...。
限制:仅支持 macOS;读取数据库失败时需为调用方(手动运行为 Terminal,网关运行为 Moltbot.app)授予完全磁盘访问权限;可用 THINGSDB 或 --db 指定数据库目录。当前 things3-cli 不支持写入删除或移入废纸篓,things trash 只读,删除需在 Things UI 操作,或改用标记完成/取消。--dry-run 只打印 URL 不打开 Things。收费、价格、平台与效果等资料暂未提供。