用 Agent Autoloop 让命令行 Agent 在后台接活：安装试跑、rules.json 定时与事件规则、问答闸门与补跑追溯实操

# 核对运行时（官方要求 Node 24 或更新）
node --version
git --version

# macOS / Linux 另需 curl
curl --version

# 确认你的命令行 Agent 已登录且能出最终回复
# 例如：codex exec "只回复 OK" 或你的 CLI 等价命令
# 这一条只是自检，不写进规则文件

# 在线审阅安装脚本（浏览器打开也可以）
# https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh
# https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1
# 重点看：安装目录、是否改 PATH、是否注册后台服务

# 准备一个可回滚的练习目录
git status --short
git log -1 --oneline

# Windows PowerShell
irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

# 安装后确认命令可用，并看初始状态
agent-autoloop status
# 预期：今天与最近 7 天的轮数 / Token / 费用都为 0

# 后续升级同样只取通过全部检查的 Release
agent-autoloop update

# 发起试跑
agent-autoloop try
# 终端输出大意：事件发出去了，Agent 开始干活……
# Agent 结束了这一轮，问了你一个问题。它现在不占进程、不花 Token。
# 【等你决定】#1 试跑：选一个颜色  1. 蓝色  2. 绿色

# 交互终端：直接输入数字回车
# 非交互终端：用命令回答（示例里的 1 2 选绿色）
agent-autoloop answer 1 2

# 再查状态，看它接上原会话把试跑做完
agent-autoloop status
# 预期：显示「你选了绿色，试跑通过」，以及今天 / 近 7 天的轮数、Token、费用

# 文件：~/.agent-autoloop/rules.json
{
  "rules": [
    {
      "name": "早报",
      "when": { "cron": "0 9 * * *" },
      "to": "codex",
      "cwd": "~/notes",
      "prompt": "整理昨天的笔记和提交，写今天的早报。"
    },
    {
      "name": "处理 issue",
      "when": { "source": "github", "types": ["issues.opened"] },
      "to": "codex",
      "cwd": "~/code/app",
      "skill": "handle-issue",
      "parallel": 3
    }
  ]
}

# 保存后先校验，不要直接等它自己触发
agent-autoloop check

# 校验当前生效规则
agent-autoloop check

# 只校验一份草稿，不碰正在跑的中台
agent-autoloop check rules-draft.json

# 看生效规则与下次定时（也可指定草稿）
agent-autoloop rules explain

# 预演一条事件会派给谁
agent-autoloop emit issues.opened --dry-run

# 立即手动跑一轮，验证闭环
agent-autoloop run 早报

# 启用模板的顺序（以每日早报为例）
# 1. 打开 examples/recipes/ 里对应说明
# 2. 模板带任务 Skill 时，把它放进所用 Agent 的 skills 目录
# 3. 把示例规则合入 ~/.agent-autoloop/rules.json
# 4. 替换里面的电脑名与路径，再跑一次 agent-autoloop check

# 暂停一条规则；暂停期间到点不跑、来事件不接也不排队
agent-autoloop pause 处理 issue

# 恢复：官方说明恢复后不自动补跑，会列出暂停期间跳过的事件
agent-autoloop resume 处理 issue
# 照给出的提示补跑，每条只补一次
agent-autoloop replay 处理 issue --since 2026-11-14T09:00

# 立即跑一轮 / 列做完的轮次 / 往前翻
agent-autoloop run 早报
agent-autoloop runs 早报
agent-autoloop runs 早报 --before 3

# 用轮次编号看来龙去脉
agent-autoloop why 3

# 升级前记下当前规则，升级后再核一次
agent-autoloop check
agent-autoloop update
agent-autoloop status