agent-autoloop简介
AI/ML
Agent Autoloop 是一个极轻量的自动化任务调度中台,专门解决命令行 AI Agent(如 Claude Code、Codex)必须“人守着终端用”的痛点。它将任务调度抽象为零外部依赖的内核,把事件来源、执行 Agent、通知通道和交付流水线全部拆分为可插拔插件。
它让 Agent 能够在本地后台自主接收定时任务或 Webhook 事件并持续跟进,干完一轮即退出进程以节省资源;只有遇到需要人工决策的高风险操作时,才会通过飞书、钉钉、Slack 或桌面通知发送卡片找人拍板,等待期间不占进程也不消耗 Token,从而实现真正的无人值守自动化闭环。
亮点特性
01挂起零消耗机制
等待人工拍板时 Agent 进程直接退出,状态持久化到数据库,不占用后台资源且不消耗 Token,回复后无缝接续原会话
02纯内核零运行时依赖
内核不读系统时钟、不用随机数、不向外发请求,冷启动仅需约 88ms,空闲内存约 60MB
03事件溯源架构
所有状态由只追加日志计算得出,事务落盘后才应答,强杀进程不丢数据,任何一轮任务的来龙去脉均可追溯
04指令与数据严格分离
外部文本仅作为资料传入,不拼入提示词,防止提示词注入攻击,事件携带越权字段会被直接拒收
05跳数熔断保护
类似网络包 TTL 机制,Agent 交回的事件再派发层数超过 8 层即停止派活并发出告警,防止死循环
使用场景
场景 1每日自动化早报
配置定时规则,每天早上自动整理本地笔记与 Git 提交记录,生成日报文件
场景 2GitHub Issue 自动跟进
监听仓库新 Issue,自动在本地拉取代码排查修复,完成后发通知让人工复核
场景 3线上告警智能排查
接收业务系统报错事件,对照代码分析原因,若需重启服务则发卡片询问运维人员后再执行
快速上手
环境要求
Node.js 24 或更新版本、Git,以及一个已登录的命令行 Agent(如 Claude Code 或 Codex)。
安装步骤
macOS / Linux:
|
Windows PowerShell:
|
快速体验
运行内置试跑流程,体验“提问 → 退出等回复 → 拍板 → 接着干完”的完整闭环:
|
根据终端提示输入选项序号,或使用命令回答:
|
查看执行状态:
|
核心配置示例
编辑 ~/.agent-autoloop/rules.json 定义调度规则,例如每天早上 9 点让 Codex 写早报:
|
保存后几秒内自动生效,可使用 agent-autoloop check 检查配置正确性。
替代方案
对比 1n8n / Zapier
通用可视化工作流平台,生态丰富但较重且通常依赖云端或 Docker 部署;本项目专为本地命令行 AI Agent 设计,更轻量且无需公网暴露
对比 2Open Interpreter
支持在终端执行代码的 AI 助手,但偏向单次交互式对话;本项目侧重于多事件源的后台持续调度与异步人工审批闭环
相关资源
项目地址github.com/KKKKhazix/agent-autoloop

