KKKKhazix/agent-autoloop

项目介绍

Agent Autoloop 是给 Claude Code、Codex 这类命令行编程 Agent 用的轻量自动化中台。平时用这类工具，人得守着终端：说一句话、等它跑、回答它的问题，关掉窗口事情就断了。这个项目把「什么事、交给谁、在哪个目录干」写成规则，由内核调度 Agent 跑完一轮、记录结果、退出进程；碰到删数据、重启服务、花钱、对外发消息这类需要人拍板的情况，推一张卡片到桌面通知或飞书，你选完它接上原来的对话继续干。等待回复期间不占进程，也不消耗 Token。

事件来源、Agent、通知通道、交付流水线都拆成可替换的插件，内置内核约 1650 行、零运行时依赖，用只追加事件日志、指令数据分离和跳数熔断作为主要机制。适合已经装好并登录了命令行 Agent、想让它在后台处理日常任务（定时简报、GitHub Issue、告警排查、网站巡检）的个人开发者和小团队。

快速使用

运行前需要 macOS 或 Linux、Node 24、Git、curl，以及任意一个已登录的命令行 Agent，不需要 GitHub 账号。

1. 用安装脚本装好：

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

2. 跑内置试跑，完整走一遍「提问 → 退出等回复 → 拍板 → 接着干完」：

agent-autoloop try

3. Agent 提问后，交互终端里直接输入数字；非交互终端用：

agent-autoloop answer 1 2

示例里选了第 2 项「绿色」。然后查看进度和用量：

agent-autoloop status

状态里会显示接上的会话，以及今天和最近 7 天的轮数、Token 和费用，统计口径见技能文档。

4. 正式使用时编辑 ~/.agent-autoloop/rules.json，在 rules 里写清楚事件、目标 Agent 和工作目录：

{
  "name": "早报",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "整理昨天的笔记和提交，写今天的早报。"
}

保存后几秒内生效，运行 agent-autoloop check 可以检查；改错了会继续按旧规则跑并收到提醒卡片。

已有场景模板覆盖每日早报、跟进 GitHub Issue、线上告警排查、用户反馈处理、网站巡检和飞书周报，每套都带规则和任务 Skill，见场景模板。

使用约束

• 平台： 仅说明支持 macOS 和 Linux，未提及 Windows。
• 凭据与计费： 中台调用本机已登录的命令行工具，不读取或转存账号凭据；模型消耗算在你自己的账号名下，遵循各家厂商服务条款。高频自动化或对外提供服务时，README 建议改用 API Key，而不是个人订阅额度。
• 通道实测范围： Claude Code、Codex 和 ACP 跑通了多轮问答和跨进程会话续接，飞书跑通了发送、按钮回调和卡片更新；钉钉、企微、Slack、Discord 四种 Webhook 模板只在本地模拟服务上验证过。文字通道靠回答链接拍板，需要把 hub.publicUrl 配成手机或电脑能打开的地址。
• 其他 Agent： 提供 use: "command" 的一行接入方式，DeepSeek Harness、pi、OpenClaw、Hermes、Cursor、CodeBuddy 的命令整理自各家官方文档，但未逐个跑过。
• 示例数据： 反馈处理、网站巡检和飞书摘要模板使用虚构样例，只用本地 HTTP 和假飞书 CLI 验证过，没有在真实账号上跑完整业务。
• 历史增长： 历史变多后状态汇总会变慢；格式变化后的首次启动要从日志全量重建，110 万条用时 43.1 秒。
• 许可证： MIT。

HotRepo 点评

在 HotRepo 新项目榜 2026-11-04 的记录里，这个项目是 429 Star、87 Fork，在 2026-11-03 开始的统计窗口内净增 429 Star。这只是单次快照，不是连续趋势，只能说明它上线初期就获得了关注。

关注背后对应的是几个具体设计：零依赖内核和只追加日志、等人工拍板时 Agent 会话退出挂起、把外部 Issue 文本与提示词分离。README 也明确划出了没测过的部分——Webhook 通道、额外的 Agent 命令、部分样例流程——对打算把它接到真实仓库或账号上的人来说，这比星数更值得先看清楚。