用途：toodledo-pp-cli 是一个把 Toodledo 任务系统搬到终端的命令行工具，适合智能体或脚本离线、低成本地读取和修改 Toodledo 数据，例如列出下一步行动、执行每周回顾、批量收集任务、汇总目标进度或用 SQL 查询任务。
主要能力：将整个任务数据镜像到本地 SQLite，因此多数读取不消耗 API 调用，这点很关键，因为 Toodledo 每个访问令牌限制 100 次 API 调用。独有能力包括 next-actions（按优先级和截止日期排序的未完成下一步行动，可按情境或目标过滤）、review（一次性给出收件箱、逾期、停滞项目、等待中、将来/也许五类每周回顾状态）、stalled-projects（有未完成任务但无下一步行动的项目）、goal-progress（按终身/长期/短期目标层级汇总完成与未完成任务数）、dashboard（按状态、优先级、文件夹、情境统计的看板）、sync-cost（预估一次增量同步会消耗多少次调用）、capture（从文件或标准输入按行批量添加任务，每批 50 条）。命令覆盖 account、contexts、folders、goals、lists、locations、notes、outlines、tasks 等资源，提供 add、edit、delete、list 等子命令。
使用方式：先安装 CLI，验证 toodledo-pp-cli --version。安装命令：
npx -y @mvanhorn/printing-press-library install toodledo --cli-only
失败时可回退到 Go 安装（需 Go 1.26.6 或更新）：
go install github.com/mvanhorn/printing-press-library/library/productivity/toodledo/cmd/toodledo-pp-cli@latest
认证使用 OAuth 2.0，需在 toodledo.com 注册应用获取 client id 和 secret，设置环境变量 TOODLEDO_CLIENT_ID、TOODLEDO_CLIENT_SECRET，然后运行 toodledo-pp-cli auth login。访问令牌有效期两小时并自动刷新，刷新令牌闲置 30 天后失效需重新登录。可用 toodledo-pp-cli doctor 验证配置。任意命令加 --agent 等价于 --json --compact --no-input --no-color --yes，支持 --select 筛选字段、--dry-run 预览、--deliver 路由输出到 stdout、文件或 webhook。输出带 meta/results 信封，meta.source 标明数据来自 live 还是 local。还可用 toodledo-pp-cli which "<能力描述>" 查找命令，用 profile 保存常用参数组合。MCP 安装：go install github.com/mvanhorn/printing-press-library/library/productivity/toodledo/cmd/toodledo-pp-mcp@latest，注册：claude mcp add toodledo-pp-mcp -- toodledo-pp-mcp。
适用场景：智能体驱动的 GTD 工作流、离线任务查询、批量任务收集、目标进度汇报、预算感知的同步。
限制：仅支持 Toodledo v3 API，不适用于 Todoist、TickTick、Asana、Things 等其他任务管理器；写操作直接作用于线上账户，不应在无明确确认下批量重写或删除任务历史；不提供 Toodledo API 未暴露的实时协作、分享或日历功能。令牌端点位于 Cloudflare 之后，偶尔对有效请求返回 403，CLI 会将其与真实 401 认证失败区分处理。