Things 3 命令行工具

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

设置

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

只读操作（数据库）

• things inbox --limit 50
• 今日事项
• 待办事项
• 搜索事项 "查询内容"
• 项目事项/区域事项/标签事项

编写（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 "机票"
• 从标准输入读取（多行 => 标题 + 备注）：
  • cat <<'EOF' | things add -
  • 标题行
  • 备注行 1
  • 备注行 2
  • EOF

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

• 第一步：获取ID（UUID列）：things search "牛奶" --limit 5
• 认证：设置THINGS_AUTH_TOKEN或传递--auth-token <TOKEN>
• 标题：things update --id <UUID> --auth-token <TOKEN> "新标题"
• 备注替换：things update --id <UUID> --auth-token <TOKEN> --notes "新备注"
• 备注追加/前置：things update --id <UUID> --auth-token <TOKEN> --append-notes "..."/--prepend-notes "..."
• 移动列表：things update --id <UUID> --auth-token <TOKEN> --list "旅行" --heading "之前"
• 标签替换/添加：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 的界面进行删除/移至废纸篓，或通过things update将其标记为--completed/--canceled。

注意

• 仅限 macOS。
• --dry-run会打印 URL 而不会打开 Things。