开源半月拿下5800星:让Claude Code自己接活、拿不准才来找你

一个不懂代码的设计师,把他折腾了一年的 Agent 自动化系统开源了。

半个月,5800 颗星。我今天在 GitHub 上核过,5792 颗,还在涨。

项目叫 Agent Autoloop,作者是数字生命卡兹克——就是那个一年前连 CI 是什么都不知道,靠 Agent 做出百万月活公益产品 AIHOT 的设计师。

先别急着说“又一个套壳工具”。我把他的两篇长文和整个仓库的 README 翻完了,今天专门讲讲,这东西凭什么半个月拿下 5800 星。

Agent Autoloop 封面卡:半月5800星,Agent自己接活

先说一个所有人都有的痛点。

现在用 Claude Code、Codex 这类命令行 Agent,基本是“人守着终端用”:你输一句话,盯着它跑,它问你答,干完检查,再派下一个活。

这个流程里有个致命设定:所有事情的起点是你。你一关窗口、一走开,什么都不会发生。

一个人的注意力,同时盯得过来的也就三五个窗口。你雇了个能力极强的员工,但这员工只在你盯着它的时候干活。

Agent Autoloop 干的事,就是把“起点是你”改成“起点是事件”。

定时任务、GitHub 上有人提了 Issue、你的系统报了错——事件一发生,自动叫醒 Agent 去干活;干完了进程自己退出;拿不准的事,才推一张卡片来找你,你点一下,它接着把活干完。

像一个真正的员工:能自己处理的自己处理掉,只有必须你拍板的事,才递到你面前。

Agent Autoloop 是什么:一张图看懂

官方架构图我一整个存下来了,内核、插件、拍板闭环全在上面。

Agent Autoloop 官方架构图:内核四机制与插件全景
参考图:Agent Autoloop 官方架构图(内核只管收事件、分活、派活、记账,其余全是插件)

中间黑色那块是内核,叫 Autoloop,只干四件事:收事件、按规则分活、把活派给 Agent、把每一步都记下来。除此之外什么都不干,连网都不往外连。

外面一圈,事件来源、Agent、通知通道、代码交付流水线,全是插件。

真·轻量:1600 行内核,装个 Node 就能跑

我翻仓库时的第一印象就俩字:克制。

内核 1600 行左右,零第三方依赖,电脑上装个 Node 就能跑。官方基准测试的数据:冷启动 88.78 毫秒,空闲内存 59.94 MB,就算 1000 个程序同时连着它,也就 170 MB 出头;派活的 p99 延迟 1.82 毫秒。

安装是一条命令的事:Windows 一行 PowerShell,Mac 和 Linux 一行 shell。

作者的原话更彻底——安装这种事直接交给 Agent 就行。把仓库地址丢给你的 Claude Code,说一句“帮我装一下这个项目”,它自己读文档、自己装、自己试跑。

最戳人的优点:等你拍板时,它不占进程也不烧 Token

这是我最喜欢的一个设计,也是多数“自动化挂机”方案里最容易忽略的成本黑洞。

以前的方案,Agent 等你拍板,进程就一直挂着,隔几分钟问一次“回了没”。

Autoloop 借了游戏存档的思路,官方管它叫挂起零消耗:Agent 发完卡片就直接下班,等待状态存进数据库。你三天不回,这三天就没有进程在跑、零 Token 消耗;你一点卡片,它读档接上原来的对话继续干。

同一个问题,也不会问你第二遍。

拍板卡片实例:拿不准的事发卡片找你,带选项按钮
参考图:拿不准的事,Agent 会推一张带选项的卡片来问你,点一下它接着干

断电都不丢:它把银行账本搬进了 Agent

另一个我印象很深的机制,官方叫事件溯源,思路是从银行账本借来的:每发生一件事,就往后记一笔,写进去了才应答“收到”。

断网、断电、进程被强杀,已经确认的事一条不丢;同一件事,账本只会记一次,网络抖了重发也不怕重复。

仓库里自带两个模拟测试,README 里写得明明白白:20 万步模拟断网、丢包、崩溃和重复提交,一个种子就能复现;强杀进程 1000 次,已确认的记录一条不丢。

还有两个机制顺带一句:指令数据分离,外部来路不明的文字进不了提示词,防 Prompt 注入;跳数熔断,Agent 互相叫醒超过 8 层自动停,防止几个模型来回挑错把你的额度烧穿。

换 Claude Code 还是 Codex,改一行配置就行

内核只管派活,不关心里面跑的是谁。

Claude Code、Codex、DeepSeek Harness、ZCode、支持 ACP 的 Gemini CLI 和 OpenCode,都有内置插件;任何“能接收提示词、打印最后一条回复”的命令行工具,写一行配置就能接进来,不用装 SDK、不改 Agent 一行代码。

哪类事交给谁干,就是规则文件里的一行字。今天用 Claude,明天出了更强的模型,改一行就换。

通知通道也是全的:飞书、钉钉、企业微信、Slack、Discord、桌面通知(默认开着)。

完整自动化系统分层图:中台、Agent执行、CI中台、人工判断
参考图:作者完整自动化系统的分层——自动化中台 / Agent 执行 / CI 中台 / 只管拍板的你

这套完整的流水线,就是作者跑了一年的系统长出来的样子——Agent 执行、CI 中台、人工判断,各管各的层。

8 套场景模板,拿来即用

不用从零设计。我把它 README 里的模板表逐行数过,一共 8 套现成的:每日早报、GitHub Issue 跟进、线上告警排查、用户反馈处理、网站巡检、飞书周报、收件箱分诊、PR 自动交付。每套都带示例规则和启用说明,改改路径就能跑。

其中 PR 自动交付最有意思:给 GitHub 上的 PR 打一个 deliver 标签,它就自己跟完全程——审代码、等检查通过、合并、等发布,最后去线上核对版本,确认真的上线了。

作者的用法更野:每天下午让 Agent 去全网搜大家怎么聊他的产品,每周操控浏览器去各家 AI 平台问一遍自家产品的口碑,每天早上把模型榜上的价格跟各家官网对一遍账。

怎么上手:两步,两分钟

第一步,装。仓库在 github.com/KKKKhazix/agent-autoloop,Windows 在 PowerShell 跑一行安装命令,Mac 和 Linux 一行 shell;或者直接把仓库地址丢给你的 Agent,说“帮我装一下这个项目”。

第二步,试。跑 agent-autoloop try,它会真实走一遍“提问→等你拍板→接着干完”的流程:让你选个颜色,你答完,它接着跑完并汇报结果。跑完你就懂这个“雇员”的工作方式了。

配规则就是写一个 rules.json:什么事、交给谁、在哪个目录干,写完几秒自动生效。

说句公道话

优点讲完了,泼三盆冷水,都是官方自己写明的。

第一,这是 1.0.0 版本,作者自己说“肯定还有很多不完善的地方,甚至还会有一些 BUG”。

第二,README 里有一句很实诚的免责:内置模板的脚本和回执,“只用本地 HTTP 与假飞书 CLI 验证过,没有在真实账号上跑过完整业务”。照着模板改没问题,别当成开箱即生产。

第三,也是最重要的:官方明确写了,高频自动化场景下,各家厂商更建议用 API Key——个人订阅额度是为日常人工交互设计的。作者自己是 200 美元的 Claude 会员加 100 美元的 GPT 会员,按他的自述,猛用下来 3 天就烧掉近 90%。

所以这东西适合谁:有自己的电脑、在认真用命令行 Agent、想解锁“后台接活”玩法的人。你要是偶尔问两句代码,直接开窗口聊就行,犯不着上中台。

写在最后

说回那个数字:半个月,5800 星。

它证明的其实不是技术多牛——1600 行的内核,大部分设计是从银行账本、网络 TTL、游戏存档这些“别人的行业”里借来的。

它证明的是一件事:大家用 Agent 的时候,最想要的不是“更强的模型”,而是“能自己干活的员工”。

工具等人,永远等人;事件找人,才叫自动化。

对了,卡兹克的源文里还藏着不少好玩的玩法——比如让 Agent 每周去各家 AI 平台查自家产品的口碑(GEO 排查)、每天早上让 Agent 对账全网模型价格。这些怎么搬到自己电脑上,下篇拆。关注别错过。

装它要花钱吗?

A:项目本身 MIT 协议免费开源,跑在你自己的电脑上,不用买云服务器、不用开公网端口。要花钱的是 Agent 的 Token 消耗,走你自己的账号,README 也提醒了高频自动化建议用 API Key。

除了 Claude Code 和 Codex,还支持哪些 Agent?

A:内置 Claude Code、Codex、ACP、DeepSeek Harness、ZCode 和通用命令插件;README 还整理了 pi、OpenClaw、Hermes、Cursor、CodeBuddy 等各家的一行接入命令。理论上任何命令行 Agent 都能接。

跟自己写 cron 定时脚本有什么区别?

A:自己写的话,每种事件、每个 Agent、每个通知渠道都要单独写一套胶水代码,三五个还行,十几个一定乱。Autoloop 把这些抽成统一的规则和插件,外加去重、断电恢复、防死循环这些你自己不想写的东西。