一句话总结
平时我们用 Claude Code、Codex 这类命令行 Agent，大多是「人守着终端用」——你输一句话，盯着它跑，等它问你下一步；一旦关掉窗口或者人走开，事情就断了。agent-autoloop 要做的，就是给这些 Agent 装一个「自动接活」的中台：它在后台自己接任务、自己干、干完退出；只有碰到删数据、重启服务、花钱、对外发消息这类拿不准的事，才推一张卡片到飞书或桌面通知，等你拍板。
项目 11 月 3 日才上线，两天就冲到了 2500+ 星。作者 KKKKhazix 用 TypeScript 写了一个约 1800 行、零运行时依赖的内核，把事件来源、Agent、通知通道、代码上线流水线全部拆成可插拔的插件。
图源：github.com/KKKKhazix/agent-autoloop 仓库页
它解决了什么问题
命令行 Agent（Claude Code、Codex 等）的能力已经很强，但用法上有个结构性缺陷：它们是「会话式」工具，不是「常驻式」工具。你一离开终端，它就只能停下来等你。
这带来几个实际痛点：
- 必须人守着。定时任务、GitHub Issue、线上报错这些「事件」不会自己变成 Agent 的工作，得你手动把它们敲进去。
- 等待即烧钱。Agent 问你「要不要删这条数据」时，如果它一直挂着等你，进程在跑、Token 在烧。你要是一天没回，它可能白烧一天。
- 没有统一调度。多个 Agent、多个目录、多个任务，各跑各的，没有规则可循。
agent-autoloop 的答案是：把「事件驱动的自动化」搬到命令行 Agent 上。它的口号很直白——「平时不烦你，遇到拿不准的事才发卡片找你拍板」。
工作原理：内核 + 四类插件
整个项目围绕一个极轻量的内核展开，内核只做一件事：把任务调度跑通。其他能力——怎么发现新活、谁来干活、去哪找你拍板、怎么上线——全部是围绕内核的插件。
图源：github.com/KKKKhazix/agent-autoloop 项目架构图（docs/architecture.svg）
四个方向都能自由替换：
| 方向 | 做什么 | 内置实现 |
|---|---|---|
| 事件 | 怎么发现新活 | GitHub Webhook、GitLab Webhook、HTTP 接口、定时规则、Issue 轮询脚本 |
| Agent | 谁来干活 | Claude Code、Codex、ACP、通用命令 |
| 通道 | 去哪找你拍板 | 桌面通知（默认）、飞书、钉钉、企微、Slack、Discord |
| 交付 | 把 CI/CD 也做成插件 | delivery 交付流水线 |
「事件」和「Agent」解耦意味着：你可以在早 9 点的定时任务里，把「整理昨天的笔记和提交、写今天的早报」派给 Codex；也可以在有人提 GitHub Issue 时，把「在本地改代码并通知你查看」派给 Claude Code。谁干什么活，全写在一个 rules.json 里。
上手安装
安装门槛极低：一台 Mac 或 Linux，装好 Node 24、Git、curl，再加上任意一个你已经登录好的命令行 Agent（不需要 GitHub 账号，不需要云服务器，不需要开放公网端口）。
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
装好后，让本机 Agent 真实走一遍「提问 → 退出等回复 → 拍板 → 接着干完」的流程：
agent-autoloop try
终端里会看到这样的真实输出：
事件发出去了，Agent 开始干活……
Agent 结束了这一轮，问了你一个问题。它现在不占进程、不花 Token。
【等你决定】#1 试跑：选一个颜色
这是一次试跑，选哪个都行。
1. 蓝色
2. 绿色
回答：agent-autoloop answer 1 <序号>
答完运行 agent-autoloop status，能看到它接着把活干完。
图源：github.com/KKKKhazix/agent-autoloop README
注意一个关键点：当前只有 macOS 和 Linux 版。Windows 版作者明确表示要等 11 月 7、8 日回家后开发并测试，进度在项目的 issue #17 里跟踪。
一件事怎么转起来
完整的流程五步，对应架构图里的编号：
- 新事件进来。早上 9 点的定时任务、GitHub 上新提的 Issue、业务系统报的错，都变成一条标准事件送进内核。
- 按规则派活。内核照你写的
rules.json，决定交给哪个 Agent、去哪个目录干。同一件事排队时又来的消息，会合并成一轮处理。 - 干完一轮就退出。Agent 把结果写在最后一条回复里，进程直接退出——不占后台进程、不烧 Token。
- 拿不准才问你。碰到删数据、重启服务、花钱、对外发消息这类事，内核通过飞书或桌面通知发一张卡片。等你回复期间，没有 Agent 进程在跑。
- 点一下，接着干。你选完，它接上原来的对话，把剩下的活干完。
日常配置就是写一份 rules.json，不需要写胶水代码。比如每天早上 9 点写早报：
{
"name": "早报",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "整理昨天的笔记和提交，写今天的早报。"
}
中台对 Agent 只有一个约定：在最后一条回复里交代结果。需要请示时，在回复末尾附一段 agent-autoloop 代码块，用 JSON 描述问题（ask 提问、notice 通知、resolve 结案、later 预约复查、events 触发新事件）。
拿来即用的场景模板
每套模板都带规则、任务 Skill 和启用说明，开箱即用：
| 想做什么 | 已经封装好的流程 |
|---|---|
| 每日早报 | 默认每天 8 点整理本地笔记和 Git 提交，写入 briefs/YYYY-MM-DD.md |
| 跟进 GitHub Issue | 每 5 分钟查新 Issue，本地改代码并通知你查看；不提交、不推送、不回复 Issue |
| 线上告警排查 | 接收报错、对照代码查原因，需要重启时发卡片询问，回答后继续 |
| 用户反馈处理 | 重读反馈、修复、交付核实、准备回复；需要决定时飞书问你 |
| 网站巡检 | 每 5 分钟检查状态和关键内容，首次异常交给 Agent，恢复后更新原卡片 |
| 飞书周报 | 周日 18 点按权限读汇报和表格，生成摘要，飞书只发简短版 |
| PR 自动交付 | 打上 deliver 标签后，审查 → 等 CI → 合并 → 等发布 → 核对线上版本 |
其中「PR 自动交付」最能体现设计思路：给 GitHub PR 打上 deliver 标签后，它会自己跟进到上线。审查和交付配置只从 main 读取，绝不在接单电脑上检出或运行 PR 里的代码，安全边界清晰。
内核的四个机制
内核约 1800 行代码、零运行时依赖，这是它最让人眼前一亮的地方。它不读系统时钟、不用随机数、不向外发请求——插件主动连进来，账号凭据留在各自的插件里；同样的输入永远得出同样的结果。作者把四个计算机领域的成熟做法用到了命令行 Agent 上：
- 挂起零消耗：等你拍板时进程直接退出，等待状态存在数据库里。你三天没回，这三天就没有 Agent 进程在跑、不花 Token，只有很轻的中台在后台等着；你一回答，它接着原来的对话继续干。
- 事件溯源：所有状态都从一条只追加的日志算出来，日志和索引在同一个事务里写进磁盘，写完才应答。进程被强杀，已经确认的事也不会丢。
- 可插拔插件：四个方向（事件/Agent/通道/交付）都能用一行
agent-autoloop add <git 地址>装第三方插件，也能照最小模板自己写。 - 跨进程会话续接：会话接不上才开新的；接上了、干到一半断了，过几分钟回到原会话重试，不开新会话重做。
实测跑通的情况：Claude Code、Codex 和 ACP（官方 Codex ACP 适配器）完成了多轮问答和跨进程会话续接；飞书跑通了发送、按钮回调和卡片更新。
同类工具对比
| 维度 | agent-autoloop | 手动用 Claude Code / Codex | 云编排平台（如 n8n 等） |
|---|---|---|---|
| 触发方式 | 定时 / Webhook / HTTP 事件驱动 | 人手动敲命令 | 可视化流程编排 |
| 等待时占用 | 进程退出，零 Token 消耗 | 终端挂着等回复 | 常驻进程 |
| 部署要求 | 一台本机，无云服务器 | 无 | 需要服务器/云 |
| 拍板方式 | 飞书/钉钉/企微/桌面卡片 | 终端里回答 | 平台内审批 |
| 可编程性 | 插件 + rules.json | 全靠会话 | 低代码为主 |
它的定位很清晰：给已经习惯命令行 Agent 的开发者一个「挂机自动化」的轻量方案，不引入云编排平台的重度依赖。代价是当前只支持 macOS/Linux，且需要你自己已经登录好 Agent。
总结
- 两天 2500+ 星，说明「命令行 Agent 后台自动化」戳中了真实痛点——人不想一直守着终端。
- 内核极简（约 1800 行零依赖）＋四类可插拔插件，是它设计上最值得借鉴的地方。
- 挂起零消耗是关键创新：等拍板时进程退出，不烧 Token，这是传统「Agent 常驻」方案做不到的。
- 拿不准才打扰的交互哲学，把 Agent 从「要人盯」变成「自动干活、关键处请示」。
- 当前仅 macOS/Linux，Windows 版预计 11 月 7、8 日推出。
对想把自己的命令行 Agent「挂机化」的开发者来说，这是一个值得关注的信号：命令行 Agent 的用法，正在出现从「守着终端」到「事件驱动、无人值守」的转向。
图片出处：项目架构图、GitHub 仓库页与试跑终端输出取自 github.com/KKKKhazix/agent-autoloop；封面由 UU AI Hub 自制。
