SuperAPI AI 工具集

things-mac

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:在 macOS 上通过 things CLI 读取本地 Things 3 数据库(收件箱、今天、搜索、项目、领域、标签),并用 Things URL scheme 新增或更新待办事项。

安装与配置:可先用 which things 检查是否已安装;Homebrew 安装命令为 brew install ossianhempel/tap/things3-cli;Go 方式(Apple Silicon 推荐)为 GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest。可选设置 THINGSDB 或 --db 指向 ThingsData-* 目录。更新操作需要认证令牌,可在 shell 配置(如 ~/.zshrc)中设置 THINGS_AUTH_TOKEN 持久保存。

读取能力:things inbox --limit 50、things today、things logtoday、things createdtoday、things upcoming、things deadlines、things search "query"、things projects、things areas、things tags;查看内容可用 things show "Area Name"、things tasks --area "Area Name"、things tasks --project "Project Name"。

写入能力:建议先用 things --dry-run add "Title" 安全预览。新增如 things add "Title" --notes "..." --when today --deadline 2026-01-02,支持 --when=someday、--later、--when=evening 等排期,可用 --foreground 将 Things 置前。支持 --list 指定项目/领域、--heading 指定标题、--tags 添加标签、--checklist-item 创建检查项、--repeat 与 --repeat-mode 设置重复。也可从 STDIN 以 things add - 读取多行内容(首行标题、其余为备注)。

项目与领域:things add-area "Health"、things add-project "New Site" --area "Work" --notes "...",更新用 things update-project。更新待办需先通过 things search 获取 UUID,再带上 --auth-token 执行标题、备注、列表、标签变更,或标记 --completed/--canceled。删除待办通过 AppleScript:things delete --id <UUID>,另有 delete-project、delete-area;默认交互确认,脚本中可用 --confirm。

限制:仅支持 macOS;--dry-run 只打印 URL,不会打开 Things;更新与标记操作需要认证令牌。资料未提供收费、价格或平台兼容范围等信息。