Agent Autoloop

项目简介

Agent Autoloop 是一个极轻量的自动化中台，面向 Claude Code、Codex 等命令行 Agent。它把定时任务、GitHub Issue、业务告警等变成标准事件，按本机规则决定交给哪个 Agent、在哪个目录执行；Agent 干完一轮就退出，遇到需要用户拍板的事才发卡片询问，回答后接上原会话继续完成。它不依赖云服务器或公网端口，可在个人 Mac 或 Linux 上运行。

核心功能

• 单机运行：一台电脑、一条命令即可启动，不需要云服务器或开放公网端口。
• 规则派活：在 rules.json 中配置什么事、交给谁、在哪个目录干，定时任务与外部事件共用同一套规则。
• 挂起零消耗：等待用户拍板时进程退出，不占 Agent 进程、不消耗 Token；回答后恢复原会话继续。
• 可插拔体系：事件来源、Agent、通知通道和交付流水线均可替换，内置 GitHub/GitLab Webhook、Claude Code、Codex、ACP、飞书等插件。
• 内核机制：零运行时依赖，采用事件溯源、指令数据分离和跳数熔断，支持查询每一轮的来龙去脉。
• 场景模板：提供每日早报、GitHub Issue 跟进、线上告警排查、用户反馈处理、网站巡检等现成流程。

适用场景

• 每日早报：按定时规则整理本地笔记和 Git 提交，写入 briefs/YYYY-MM-DD.md。
• 跟进 GitHub Issue：定时查新 Issue，在本地改代码并通知查看；不提交、不推送、不回复 Issue。
• 线上告警排查：接收报错、对照代码查原因，需要重启服务时发卡片询问，回答后继续。
• 网站巡检：每 5 分钟检查状态和关键内容，首次异常交给 Agent，持续异常不重复通知，恢复后更新原卡片。

快速开始

• 在 macOS 或 Linux 上使用项目提供的 install.sh 安装；安装和 agent-autoloop update 都取最新 Release。
• 运行 agent-autoloop try，用本机已登录的 Agent 真实走一遍提问、退出等回复、拍板、继续干完。
• 打开 ~/.agent-autoloop/rules.json，在 rules 中写清什么事、交给谁、在哪个目录干；保存后几秒内自动生效。
• 运行 agent-autoloop check 检查规则；可用 agent-autoloop rules explain 查看生效规则和下次定时。

部署与要求

• 支持 macOS 和 Linux；Windows 版待定，当前不能在 Windows 上使用，等不及可先用 WSL2 并查看安装说明。
• 运行前需要 Node 24、Git、curl，以及任意一个已登录的命令行 Agent；不需要 GitHub 账号。
• 安装在个人 Mac 或 Linux 上，不需要购买云服务器，也不需要开放公网端口。
• 默认开启桌面通知；飞书、钉钉、企微、Slack、Discord 等通道需要按插件说明配置。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• Windows 版仍待定，当前还不能在 Windows 上使用。
• 运行依赖 Node 24、Git、curl 和一个已登录的命令行 Agent，属于外部依赖准备。
• 高频自动化场景下，模型厂商通常更建议使用 API Key。
• 四种 Webhook 模板只在本地模拟服务验证，GitLab Webhook 未连接真实 GitLab。
• 部分场景模板的样例数据为虚构，脚本和回执未在真实账号跑过完整业务。