KKKKhazix/agent-autoloop
让你的命令行 Agent 在后台自己接活、自己跟进到底;平时不烦你,遇到拿不准的事才发卡片找你拍板。
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
让你的命令行 Agent 在后台自己接活、自己跟进到底;平时不烦你,遇到拿不准的事才发卡片找你拍板。 中文 | English 上手 · 场景模板 · 插件 · 内核 · 文档 平时我们用 Claude Code、Codex 这类命令行 Agent,大多是“人守着终端用”:你输一句话,盯着它跑,等它问你下一步;一旦关掉窗口或者人走开,事情就断了。 Agent Autoloop 是一个极轻量的自动化中台。它把任务调度做成一个零外部依赖的内核,把事件来源、Agent、通知通道,甚至代码上线流水线全部拆成可随时插拔的插件。 支持 macOS 和 Linux。运行前需要装好 Node 24、Git、curl,以及任意一个你已经登录好的命令行 Agent,不需要 GitHub 账号。也可以直接把安装说明丢给你的 Agent,让它替你装好。 装好后用你本机的 Agent 真实走一遍“提问 → 退出等回复 → 拍板 → 接着干完”: 下面是在终端里的真实输出: 交互终端里直接输入数字回车;非交互终端运行 agent-autoloop answer 1 2 选择“绿色”。再跑 agent-autoloop status,就能看到它接上刚才的会话并显示“你选了绿色,试跑通过”,还有今天和最近 7 天的轮数、Token 和费用(统计口径)。 编号和上面的架构图一一对应: 能自己搞定的事走图上方的自动闭环:直接办完,或者约个时间(比如半小时后)再醒来复查,全程不打扰你。 不需要写胶水代码。打开 /.agent-autoloop/rules.json,在 rules 里写清楚什么事、交给谁、在哪个目录干。to 填 agents 里已有的名字。比如每天早上 9 点写早报: 外部事件写法一样,只是要先接好来源。比如有人提新 Issue 时交给 Codex,先按说明在 sources 里登记 github: 保存后几秒内自动生效,可以运行 agent-autoloop check 检查。就算改错了,或者文件被删、读不到,系统也会继续按旧规则跑,并发卡片提醒你。 中台对 Agent 只有一个约定:在最后一条回复里交代结果。事情办完了,正常输出一句结论就行。需要向你请示时,在回复末尾附一段 agent-autoloop 代码块: 除了提问(ask),还能发通知(notice)、关闭已解决的卡片(resolve)、预约复查(later)和触发新事件(events)。通告不需要回答,但结案时可以顺手写一句处理说明,这句话会留在卡片上。万一 JSON 写错了,中台只让它在原会话里重写最后这段回复,不会把已经干完的业务重做一遍;重写也失败时,保留原结论并通知你回执没有生效。接着旧会话跑也一样:会话接不上才开新的;接上了、干到一半断了,就算没跑成,过几分钟回到原会话重试,不开新会话重做。 每套模板都带规则、任务 Skill 和启用说明。 启用: 打开对应说明,把任务 Skill 放进所用 Agent 的 skills 目录,把示例规则合入 /.agent-autoloop/rules.json,替换电脑名和路径,再运行 agent-autoloop check。 反馈处理、网站巡检和飞书摘要默认使用北京时间,只发给本人的飞书私聊。样例数据都是虚构的;脚本和回执只用本地 HTTP 与假飞书 CLI 验证过,没有在真实账号上跑过完整业务。 更多模板:Claude 委托 Codex 处理网页、每周代码清理、交付 PR。 内置插件随程序安装,填好配置即可启用;第三方插件用 agent-autoloop add 安装。 实测情况: Claude Code、Codex 和 ACP(官方 Codex ACP 适配器)跑通了多轮问答和跨进程会话续接;飞书跑通了发送、按钮回调和卡片更新;四种…
Read the full README ↗ · Preview checked 2026-11-04T13:20:51.910Z
Inside the original README — Document outline
- Agent Autoloop
- 它解决什么问题?
- 上手
- 一件事怎么转起来
- 日常怎么配?
- 写一份规则(rules.json)
- Agent 怎么跟中台配合?
- 拿来即用的场景模板
- 插件体系:四个方向都能自由替换
- 内核的四个机制
- 自己跑一遍
- 实测性能
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
让你的命令行 Agent 在后台自己接活、自己跟进到底;平时不烦你,遇到拿不准的事才发卡片找你拍板。
Repository facts
- Owner
- KKKKhazix
- Primary language
- TypeScript
- Stars
- 1,951
- Forks
- 393
- Open issues + pull requests
- 5
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-11-03T08:02:11.000Z
- Last push
- 2026-11-04T12:17:04.000Z
Topics and intended use
Owner-supplied topics: ai-agents, automation, claude-code, cli, codex, event-driven, mcp, nodejs, self-hosted, typescript, workflow
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-11-04T12:19:48.491Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.