things-mac

Name: things-mac
Author: openclaw

github.com/openclaw生产力393.3k5.2k 次安装今天更新

关于 things-mac

things-mac 是 macOS 上操作 Things 3 的命令行技能，可读取本地任务数据，并通过 Things URL scheme 添加或更新待办事项。

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaw/openclaw --skill things-mac

安装后在 Claude Code 中输入/things-mac确认已加载。

使用 things 读取本地 Things 数据库（收件箱/今天/搜索/项目/区域/标签），并通过 Things URL 方案添加/更新待办事项。

设置

安装（推荐，Apple Silicon）：GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
如果数据库读取失败：请为调用应用授予完全磁盘访问权限（手动运行时为 Terminal；网关运行时为 OpenClaw.app）。
可选：设置 THINGSDB（或传入 --db），指向你的 ThingsData-* 文件夹。
可选：设置 THINGS_AUTH_TOKEN，以免在更新操作时传入 --auth-token。

只读（数据库）

写入（URL 方案）

示例：添加待办事项

基本：things add "Buy milk"
包含备注：things add "Buy milk" --notes "2% + bananas"
添加到项目/区域：things add "Book flights" --list "Travel"
添加到项目标题：things add "Pack charger" --list "Travel" --heading "Before"
包含标签：things add "Call dentist" --tags "health,phone"
清单：things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
从 STDIN 输入（多行 => 标题 + 备注）：
- cat <<'EOF' | things add -
- Title line
- Notes line 1
- Notes line 2
- EOF

示例：修改待办事项（需要身份验证令牌）

首先：获取 ID（UUID 列）：things search "milk" --limit 5
身份验证：设置 THINGS_AUTH_TOKEN 或传入 --auth-token <TOKEN>
标题：things update --id <UUID> --auth-token <TOKEN> "New title"
替换备注：things update --id <UUID> --auth-token <TOKEN> --notes "New notes"
追加/前置备注：things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
移动列表：things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"
替换/添加标签：things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
完成/取消（有点类似软删除）：things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
安全预览：things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

删除待办事项？

目前 things3-cli 不支持此操作（没有“删除/移到废纸篓”写入命令；things trash 仅用于只读列出）。
可选方案：使用 Things UI 删除/移到废纸篓，或通过 things update 标记为 --completed / --canceled。

注意事项

支持 Markdown