出门半小时,Claude Code 就停在一个问题上干等你?Agent Autoloop 让它拿不准才来问
按作者在 README 里的说法,平时用命令行 Agent(Claude Code、Codex 这类在终端里干活的 AI)大多是“人守着用”:你输一句话,盯着它跑,等它问下一步;窗口一关或人一走,事情就断了。Agent Autoloop 在中间加了一层很轻的调度程序,装在你自己的 Mac 或 Linux 上,不用云服务器,也不用开放公网端口。
01一件事是怎么转起来的
先有一个“事件”:早上 9 点的定时任务、GitHub 上有人新提了 Issue、线上系统报了错,都算。程序按你写的规则,决定交给哪个 Agent、去哪个目录干活。Agent 干完一轮就退出,结果写在最后一条回复里。
遇到删数据、重启服务、花钱、对外发消息这类事,Agent 会在回复末尾附一段请示,程序把它变成一张卡片,推到桌面通知,或者飞书、钉钉、企业微信、Slack、Discord。你点一下选项,它接上原来的对话,把剩下的做完。
这里最值得留意的一点是:等你回答的时候,Agent 进程是退出的。你三天没回,这三天没有进程在跑,也不花 Token,只有那个轻量调度在等。
02规则长什么样
规则放在 ~/.agent-autoloop/rules.json 里,不用写代码,写清“什么时候、交给谁、在哪个目录、让它干什么”。官方 README 里的例子是每天早上 9 点写早报:
{
"name": "早报",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "整理昨天的笔记和提交,写今天的早报。"
}保存后几秒内生效,可以用 agent-autoloop check 检查。改错或文件读不到时,它会继续按旧规则跑,并发卡片提醒你。外部事件(比如“有人提新 Issue 就交给 Codex”)写法类似,只是要先在 sources 里登记来源,说明在项目的 SKILL.md 里。
03装之前要有什么
支持 macOS 和 Linux,Windows 版暂时没有,作者说周末(11 月 7、8 日)回家后会开发。需要先装好 Node 24、Git、curl,以及一个已经登录好的命令行 Agent。官方给的安装命令是下面这条,装完用 agent-autoloop try 能走一遍“提问、退出等回复、拍板、接着干完”的演示。执行 curl 管道脚本之前,建议先打开仓库里的 install.sh 看一眼。
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
内置的 Agent 插件有 Claude Code、Codex、ACP 和“通用命令”。通用命令的意思是:只要某个命令行工具能接收一段提示词、并把最后一条回复打印出来,就能一行配置接进来。README 还列了 DeepSeek Harness、pi、OpenClaw、Hermes、Cursor 等的接入命令,作者注明这些是按各家官方文档整理的,还没有逐个跑过,所以接这些之前先自己核对一下。
04几个能直接拿去用的现成流程
- 每日早报:默认每天 8 点整理本地笔记和 Git 提交,写进 briefs/ 目录。
- 跟进 GitHub Issue:每 5 分钟查一次新 Issue,在本地改代码并通知你查看,不提交、不推送、不回复 Issue。
- 线上告警排查:接收报错、对照代码查原因,需要重启时发卡片问你,答完继续。
另有一条“交付流水线”:给 GitHub PR 打上 deliver 标签后,它按“审代码、等 CI、合并、等部署、核对线上版本”往下走。作者写明审查配置只从 main 分支读取,不会在接单的电脑上检出或运行 PR 里的代码。
05有几处要留心
这个项目建仓才两三天,作者自己写明部分通道只在本地模拟环境验证过:飞书跑通了发送和按钮回调,四种 Webhook 模板只在模拟服务上试过,GitLab 没连过真实服务。文字类通道靠点链接回答,需要把 hub.publicUrl 配成手机或电脑能打开的地址。
另外,让 Agent 在无人看管时改代码,本身就有风险。它的默认做法是把删数据、花钱、对外发消息都挡在“先问你”这一关,而且 Issue 里的标题和正文只当资料放进文件,不拼进提示词,用来防提示词注入。我会先从“每日早报”这种只读的流程试起,确认卡片能收到、能回答,再考虑接 Issue。


DeepSeek
Claude Code
Timestral