name: things-mac
description: 通过 macOS 上的 things 命令行界面管理 Things 3（通过 URL 方案添加/更新项目和待办事项；从本地 Things 数据库读取/搜索/列出）。当用户要求 Otto 添加任务到 Things、列出收件箱/今天/即将到来、搜索任务或检查项目/区域/标签时使用。
homepage: https://github.com/ossianhempel/things3-cli
metadata:
{
“otto”:
{
“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 命令行界面
使用 things 读取本地 Things 数据库（收件箱/今天/搜索/项目/区域/标签）并通过 Things URL 方案添加/更新待办事项。
安装
- 安装（推荐，Apple Silicon）：
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest - 如果数据库读取失败：授予调用应用完全磁盘访问权限（手动运行时为终端；网关运行时为
Otto.app）。 - 可选：设置
THINGSDB（或传递--db）指向您的ThingsData-*文件夹。 - 可选：设置
THINGS_AUTH_TOKEN以避免为更新操作传递--auth-token。
只读（数据库）
things inbox --limit 50things todaythings upcomingthings 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 "机票" - 从 STDIN（多行 => 标题 + 笔记）：
cat <<'EOF' | things add -标题行笔记行 1笔记行 2EOF
示例：修改待办事项（需要认证令牌）
- 首先：获取 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 UI 删除/移动到垃圾桶，或通过
things update标记为--completed/--canceled。
注意
- 仅限 macOS。
--dry-run打印 URL 并不打开 Things。