SuperAPI AI 工具集

things-mac

数据与分析

查看项目

更新于 10-15 21:38

技能介绍

用途:在 macOS 上通过 things 命令行管理 Things 3,既能只读查询本地数据库,也能写入待办与项目。

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

安装:GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。若数据库读取失败,需为调用方授予完全磁盘访问权限(手动运行给 Terminal,网关运行给 Otto.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 --dry-run add "Title"。添加:things add "Title" --notes "..." --when today --deadline 2026-01-02;可加 --list、--heading、--tags、--checklist-item,也支持从 STDIN 传入多行(首行为标题,其余为备注)。更新需认证:先 things search "milk" --limit 5 获取 UUID,再 things update --id <UUID> --auth-token <TOKEN> 配合 --notes、--append-notes、--prepend-notes、--list、--heading、--tags、--add-tags、--completed、--canceled 等。

限制:仅支持 macOS;当前不支持删除或移入废纸篓的写入命令,things trash 仅可列出,删除需用 Things 界面或改为标记完成/取消;--dry-run 只打印 URL 不打开 Things。