SuperAPI AI 工具集

things-mac

数据与分析

查看项目

更新于 10-16 00:04

技能介绍

用途:在 macOS 上通过 things CLI 读写 Things 3。读取操作用本地 Things 数据库,写入操作走 Things URL scheme。

主要能力:读取收件箱、今天、未来、搜索、项目、领域、标签;添加待办(可带备注、时间、截止日期、所属列表、标题、标签、清单项);更新待办(改标题、备注替换/追加/前置、移动列表与标题、替换或新增标签、完成或取消)。支持 --dry-run 预览生成的 URL 而不打开 Things,支持 --foreground 将 Things 置于前台,支持从 STDIN 传入多行内容(首行为标题,其余为备注)。

安装与配置:推荐 Apple Silicon 使用 GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。若数据库读取失败,需给调用方应用授予完全磁盘访问权限(手动运行给 Terminal,网关运行给 Moltbot.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、things update --id <UUID> --auth-token <TOKEN> --completed。

适用场景:自动化整理待办、批量查询本地任务、脚本化添加或更新条目。

限制:仅支持 macOS。更新操作需要认证令牌。当前 CLI 不支持删除或移入废纸篓的写入命令,things trash 仅可读取列表;需删除可用 Things 界面,或改用 --completed/--canceled 标记。--dry-run 只打印 URL,不会打开 Things。关于收费、价格与官方支持情况,资料暂未提供。