用途：当智能体任务需要以编程方式操作 Trigger.dev 时使用，例如排查失败运行、审计调度健康、对比环境变量、计算跨运行 LLM 成本、监听新失败。它与官方 CLI 互补，后者偏部署与开发流程，本工具暴露管理 API 为可脚本化命令，并提供离线全文检索与类型化退出码。
主要能力：runs watch 在新失败出现时中断终端并给出桌面通知、声音与非零退出；schedules stale 列出停止触发或近期成功率低的调度，用于发现僵尸定时任务；runs span-cost 按模型和任务汇总最贵的 LLM span，含 token 与费用；failures top 按时间窗口聚合重复的（任务、错误签名）对；runs find 基于本地同步表做 FTS5 检索；envvars diff 对比两个环境的变量并遮蔽值；runs get 返回类型化退出码（0 完成、20 失败、21 崩溃、22 系统故障、23 取消、3 未找到、4 鉴权错误）。命令覆盖 batches、deployments、projects、query、queues、runs、schedules、tasks、timezones、waitpoints。
使用方式：先安装 CLI：npx -y @mvanhorn/printing-press-library install trigger-dev --cli-only，并用 trigger-dev-pp-cli --version 验证；失败可回退 go install github.com/mvanhorn/printing-press-library/library/developer-tools/trigger-dev/cmd/trigger-dev-pp-cli@latest（需 Go 1.26.6+）。鉴权使用 TRIGGER_SECRET_KEY，按环境区分 tr_dev_、tr_prod_、tr_pat_ 前缀。运行 trigger-dev-pp-cli doctor 检查配置。任何命令可加 --agent，展开为 --json --compact --no-input --no-color --yes。可用 --select 裁剪字段、--dry-run 预览、--deliver file/webhook 投递输出、profile 保存常用参数。可用 which "<能力描述>" 找命令，feedback 记录使用反馈。也提供 MCP 服务器：go install .../cmd/trigger-dev-pp-mcp@latest，再用 claude mcp add trigger-dev-pp-mcp -- trigger-dev-pp-mcp 注册。
适用场景：失败分诊、部署窗口监控、环境变量漂移审计、按错误片段查运行、成本与延迟分析、编写带重试与幂等语义的自动化脚本。
限制：需要有效的 Trigger.dev 密钥且密钥有环境作用域，开发密钥不能管理生产运行；安装依赖 Node 或 Go 环境；离线能力依赖于本地同步数据；资料未提供配额、价格或服务等级信息。