名称： things-mac
描述： 通过 macOS 上的 things CLI 管理 Things 3（通过 URL 方案添加/更新项目和待办事项；从本地 Things 数据库读取/搜索/列出）。当用户要求 Clawdbot 向 Things 添加任务、列出收件箱/今日/即将到来、搜索任务或查看项目/区域/标签时使用。
主页： https://github.com/ossianhempel/things3-cli
元数据： {"clawdbot":{"emoji":"✅","os":["darwin"],"requires":{"bins":["things"]},"install":[{"id":"go","kind":"go","module":"github.com/ossianhempel/things3-cli/cmd/things@latest","bins":["things"],"label":"安装 things3-cli (go)"}]}}

Things 3 CLI

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

设置

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

只读操作（数据库）

• things inbox --limit 50 - 列出收件箱任务（限制 50 条）
• things today - 列出今日任务
• things upcoming - 列出即将到来的任务
• things search "查询内容" - 搜索任务
• things projects / things areas / things tags - 列出所有项目/区域/标签

写入操作（URL 方案）

• 安全预览（推荐）：things --dry-run add "标题"
• 添加任务：things add "标题" --notes "..." --when today --deadline 2026-01-02
• 将 Things 应用切换到前台：things --foreground add "标题"

示例：添加待办事项

• 基础：things add "买牛奶"
• 带备注：things add "买牛奶" --notes "2% 脱脂 + 香蕉"
• 添加到项目/区域：things add "预订机票" --list "旅行"
• 添加到项目标题下：things add "打包充电器" --list "旅行" --heading "行前准备"
• 添加标签：things add "打电话给牙医" --tags "健康,电话"
• 添加检查清单：things add "旅行准备" --checklist-item "护照" --checklist-item "机票"
• 从标准输入读取（多行：第一行为标题，后续行为备注）：
  bash cat <<'EOF' | things add - 标题行 备注行 1 备注行 2 EOF

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

1. 获取任务 ID（UUID 列）：things search "牛奶" --limit 5
2. 认证：设置 THINGS_AUTH_TOKEN 环境变量或传递 --auth-token <令牌>
3. 修改标题：things update --id <UUID> --auth-token <令牌> "新标题"
4. 替换备注：things update --id <UUID> --auth-token <令牌> --notes "新备注"
5. 追加/前置备注：things update --id <UUID> --auth-token <令牌> --append-notes "..." / --prepend-notes "..."
6. 移动列表：things update --id <UUID> --auth-token <令牌> --list "旅行" --heading "行前准备"
7. 替换/添加标签：things update --id <UUID> --auth-token <令牌> --tags "a,b" / things update --id <UUID> --auth-token <令牌> --add-tags "a,b"
8. 标记为完成/取消（类似软删除）：things update --id <UUID> --auth-token <令牌> --completed / --canceled
9. 安全预览：things --dry-run update --id <UUID> --auth-token <令牌> --completed

删除待办事项？

• 当前 things3-cli 不支持删除操作（没有“删除/移至废纸篓”的写入命令；things trash 是只读的列表命令）。
• 替代方案：使用 Things 应用界面进行删除/移至废纸篓，或通过 things update 命令标记为 --completed / --canceled。

注意事项

• 仅限 macOS 系统。
• --dry-run 参数会打印 URL 而不会打开 Things 应用。