介绍
# Things 3 CLI
使用 `things` 读取您的本地 Things 数据库（收件箱/今天/搜索/项目/区域/标签），并通过 Things URL Scheme 添加/更新待办事项。
安装 - 安装（推荐，Apple Silicon）：`GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest` - 如果数据库读取失败：授予调用应用 **完全磁盘访问权限**（Full Disk Access）（手动运行时授予 Terminal；网关运行时授予 `Clawdbot.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`
写入（URL Scheme） - 推荐安全预览：`things --dry-run add "Title"` - 添加：`things add "Title" --notes "..." --when today --deadline 2026-01-02` - 将 Things 置于前台：`things --foreground add "Title"`
示例：添加待办事项 - 基本用法：`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"` - 从标准输入（多行 => 标题 + 备注）： - `cat <<'EOF' | things add -` - `Title line` - `Notes line 1` - `Notes line 2` - `EOF`
示例：修改待办事项（需要 auth token） - 首先：获取 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`。
备注 - 仅限 macOS。 - `--dry-run` 会打印 URL 且不会打开 Things。