SuperAPI AI 工具集

things-mac

办公与效率

查看项目

更新于 10-16 06:42

技能介绍

用途:在 macOS 上用 things 命令行工具操作 Things 3。读取走本地 Things 数据库,写入走 Things URL scheme。

主要能力:读取收件箱、今天、即将到来、搜索、项目、领域、标签;添加待办(支持备注、时间、截止日期、项目/领域、标题、标签、检查清单项),更新待办(改标题、备注替换/追加/前置、移动列表、标签替换或追加、完成/取消)。

安装: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。若 DB 读取失败,需给调用方(手动运行时是 Terminal,网关运行时是 OpenClaw.app)授予完全磁盘访问权限。可用 THINGSDB 或 --db 指定 ThingsData-* 文件夹。

写入示例:things --dry-run add "Title"(安全预览);things add "Title" --notes "..." --when today --deadline 2026-01-02;things --foreground add "Title";things add "Buy milk" --list "Travel" --heading "Before" --tags "health,phone" --checklist-item "Passport"。也支持从 STDIN 读取(多行 => 标题 + 备注)。

更新需认证:设置 THINGS_AUTH_TOKEN 或传 --auth-token。先 things search "milk" --limit 5 取 UUID,再 things update --id <UUID> --auth-token <TOKEN> "New title",可用 --notes、--append-notes、--prepend-notes、--list、--heading、--tags、--add-tags、--completed、--canceled。

限制:仅 macOS;things3-cli 当前不支持删除/移入废纸篓的写入命令,things trash 只读,删除需用 Things UI 或改为完成/取消。--dry-run 只打印 URL,不打开 Things。其他细节暂未提供。