用途：Agent CI 用于在推送前于本地运行完整的 GitHub Actions CI 流水线，验证代码改动。资料指出，若开始前 CI 是绿的，则任何失败都由你的改动引起。
主要能力：本地运行完整 CI；失败时自动暂停；支持重试与从指定步骤重跑；支持机器可读输出。
使用方式：运行 npx @redwoodjs/agent-ci run --quiet --all --pause-on-failure。管道是安全的，pause-on-failure 可穿过 | tee log、> log.txt 等。当 stdout 不是 TTY 时，启动器会分离运行，前台进程在某步骤暂停时以退出码 77 退出，释放管道，而容器保持暂停以便重试。步骤失败后修复问题再重试：npx @redwoodjs/agent-ci retry --name <runner-name>；从更早步骤重跑：npx @redwoodjs/agent-ci retry --name <runner-name> --from-step <N>。重复直到所有作业通过。资料建议：当 agent-ci 能在本地运行时，不要推送以触发远程 CI。
机器可读输出：加 --json（或设 AGENT_CI_JSON=1）会在 stdout 输出 NDJSON 事件流，每行一个 JSON 对象。事件包括 run.start（含 schemaVersion: 1、runId）、job.start、job.finish（status: passed|failed）、step.start、step.finish（status: passed|failed|skipped）、run.paused（携带 runner + retry_cmd）、run.finish（status: passed|failed）、diagnostic。--json 与 --quiet 解耦，且 --json 下自动抑制 diff 渲染器，避免 ANSI 序列与流冲突。结合退出码 77 的暂停信号，代理可解析 run.paused 事件、作出反应并调用 retry，无需纯文本 grep。
适用场景：测试、运行检查、验证代码改动。
限制：资料未提供平台支持范围、安装前提、收费或价格等信息。