agent-autoloop - 让命令行 Agent 在后台自己接活、拿不准时才找你的轻量自动化中台

agent-autoloop 是一个面向命令行 Agent 的自动化中台。按项目自述，它要解决的是「人守着终端用 Agent」的问题：平时用 Claude Code、Codex 这类工具，你输一句话、盯着它跑、等它问下一步，一旦关掉窗口或人走开，事情就断了。agent-autoloop 把任务调度做成一个零外部依赖的内核，把事件来源、Agent、通知通道乃至代码上线流水线都拆成可插拔的插件，让 Agent 在后台接活、跟进到底，只在拿不准的时候发一张卡片找你拍板。它适合已经在本机装好并登录了某个命令行 Agent、希望把定时任务、Issue 跟进、告警排查这类重复流程交给机器的人。

维护者与状态

项目由 KKKKhazix 维护，仓库创建于 2026-11-03，最后提交时间为 2026-11-04。最新 release 为 v1.0.0，发布于 2026-11-03。截至 2026-11-04，仓库星标数为 2082。许可证为 MIT。

主要能力

以下能力均据项目 README 自述整理，不代表中立评测结论。

• 轻量部署：项目称「一台电脑、一条命令就能跑」，装在自己的 Mac 或 Linux 上，不需要云服务器，也不需要开放公网端口。
• Agent 接入简单：据项目说明，不需要 SDK，也不需要改 Agent 源码，凡是能接收提示词并打印最后一条回复的命令行工具都能接；对 Agent 的唯一约定是「在最后一条回复里交代结果」。
• 无后台界面：需要拍板时把卡片推到飞书、钉钉、企微、Slack、Discord 或桌面通知；想看全局进展，敲一行命令即可。
• 规则驱动派活：在 ~/.agent-autoloop/rules.json 的 rules 里写清「什么事、交给谁、在哪个目录干」，支持 cron 定时与外部事件来源；保存后几秒内自动生效，可用 agent-autoloop check 检查，规则文件损坏时按旧规则继续跑并推卡片提醒。
• 挂起零消耗：等你拍板时进程直接退出，等待状态存在数据库里；据项目说明，等待期间没有 Agent 进程在跑、不消耗 Token，回答后接上原会话继续干。
• 回执协议：Agent 可在回复末尾附 agent-autoloop 代码块，用于提问（ask）、通知（notice）、关闭卡片（resolve）、预约复查（later）和触发新事件（events）；JSON 写错时只让 Agent 重写最后一段回复，不重做已完成的业务。
• 场景模板：README 列出每日早报、跟进 GitHub Issue、线上告警排查、用户反馈处理、网站巡检、飞书周报与业务摘要、PR 自动交付等模板，每套带规则、任务 Skill 和启用说明。
• 插件体系：事件、Agent、通道、交付四个方向均可替换，内置插件随程序安装，第三方插件用 agent-autoloop add 安装。
• 内核机制：项目称内核约 1650 行代码、零运行时依赖，采用事件溯源、指令数据分离与跳数熔断等设计；外部文字只作为资料放进文件，不拼进提示词，事件里带 cwd、agent、access 字段会被直接拒收。

使用入口

仓库地址：KKKKhazix/agent-autoloop。

据项目说明，运行前需要 macOS 或 Linux、Node 24、Git、curl，以及任意一个已登录的命令行 Agent，不需要 GitHub 账号。安装脚本如下：

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

装好后可用 agent-autoloop try 走一遍「提问 → 退出等回复 → 拍板 → 接着干完」的流程；用 agent-autoloop answer 回答卡片，用 agent-autoloop status 查看进展与轮数、Token 和费用统计，用 agent-autoloop why 追溯某一轮的来龙去脉。项目还提供 MCP 与命令行方式查看和回答卡片。

许可与限制

项目采用 MIT 许可证。

据 README 说明，已知限制与适用边界包括：

• 目前支持 macOS 和 Linux；Windows 版在 README 中标注为待定，作者称需回家后用 Windows 机器开发并做兼容性测试再推出。
• 文字通道靠回答链接拍板，需要把 hub.publicUrl 配成手机或电脑能打开的地址。
• 项目自述的验证情况：Claude Code、Codex 和 ACP 跑通了多轮问答与跨进程会话续接；飞书跑通了发送、按钮回调和卡片更新；四种 Webhook 模板只在本地模拟服务上验证过，GitLab Webhook 按官方文档格式测试，未连过真实 GitLab；其他命令行 Agent 的接入命令整理自各家官方文档，未逐个跑过。
• 场景模板中的反馈处理、网站巡检和飞书摘要默认使用北京时间，只发给本人的飞书私聊；样例数据为虚构，脚本和回执只用本地 HTTP 与假飞书 CLI 验证过，未在真实账号上跑过完整业务。
• 中台直接调用本机已安装并登录的命令行工具，不读取或转存账号凭据，模型调用消耗算在用户自己的账号名下；项目建议高频自动化场景使用 API Key，若对外提供服务也应使用 API Key。
• README 中给出的性能数字是在特定机器与 Node 版本下测得，项目自己也说明达标线按该机器设定，换机器可能报未达标。

项目声明为独立开源项目，与所接入的模型厂商无隶属或背书关系。