KKKKhazix GitHub avatar

agent-autoloop

TypeScript
后台自治 Agent 循环KKKKhazix最近推送 2026年11月18日
Agent 框架MIT5,7981,0666 issues7 天 +1,363

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

让命令行 Agent 在后台自动接活并跟进,只在需要决策时通过卡片通知你。

Agent Autoloop 是一个轻量级自动化中台,把任务调度做成零外部依赖的内核,将事件来源、Agent、通知通道和交付流水线拆成可插拔插件。它让你本机的 Claude Code、Codex 等命令行 Agent 在后台按规则自动处理任务,遇到拿不准的事才发卡片找你拍板。

推荐指数

4.0

适合想让命令行 Agent 脱离终端值守、实现后台自动化的开发者,配置简单且插件灵活。

近 7 天

+1,363

新增 Star

总 Star 排名

#1126

雷达追踪的 3,931 个 AI 仓库中

创建于

2026

2026年11月3日

核心亮点

  • 1零依赖内核

    一台电脑一条命令即可运行,无需云服务器或公网端口。

  • 2插件化架构

    事件源、Agent、通知通道、交付流水线四个方向均可自由替换。

  • 3人工介入卡片

    遇到删数据、花钱等关键操作时推送卡片到飞书、钉钉等,等待回复期间不耗 Token。

  • 4规则驱动

    通过 rules.json 配置何事、交给谁、在哪个目录干,保存后自动生效。

  • 5场景模板丰富

    提供早报、Issue 跟进、告警排查、网站巡检等即用模板。

适用场景

  • 定时自动化任务

    例如:每天早上 9 点让 Codex 整理笔记和提交,生成早报写入文件。

  • 外部事件响应

    例如:GitHub 有新 Issue 时自动交给 Codex 在本地改代码并通知你查看。

  • 运维告警处理

    例如:接收线上报错,Agent 对照代码查原因,需要重启时发卡片询问后继续。

  • 网站巡检

    例如:每 5 分钟检查网站状态,首次异常交给 Agent 处理,恢复后更新卡片。

它是怎么工作的

  1. 第 1 步

    事件进入

    定时任务、GitHub Issue、业务报错等变成标准事件送进内核。

  2. 第 2 步

    规则派活

    内核按 rules.json 决定交给哪个 Agent、在哪个目录执行。

  3. 第 3 步

    Agent 执行

    Agent 干完一轮后在最后一条回复里交代结果,进程退出。

  4. 第 4 步

    人工拍板

    遇到关键操作时通过飞书或桌面通知发卡片,等待回复期间不占进程不耗 Token。

  5. 第 5 步

    续接完成

    你选择后,内核接上原会话让 Agent 把剩余活干完。

快速上手

  1. 1

    安装

    Windows 用 PowerShell,macOS/Linux 用 curl 脚本安装最新 Release。

    irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex
  2. 2

    试跑

    用本机 Agent 走一遍提问、退出、拍板、继续的完整流程。

    agent-autoloop try
  3. 3

    写规则

    编辑 ~/.agent-autoloop/rules.json,配置任务、Agent 和目录。

  4. 4

    检查生效

    运行 check 命令验证规则,保存后几秒内自动生效。

    agent-autoloop check

适合谁

  • 想让命令行 Agent 后台自动运行、减少人工值守的开发者
  • 需要将 Agent 接入飞书、钉钉等通知通道的团队
  • 希望用规则驱动自动化处理 Issue、告警等重复任务的工程师

不太适合

  • 需要图形化管理界面或云端托管服务的用户
  • 不愿在本机安装 Node 24 和配置命令行 Agent 的用户

成熟度

  • 活跃度创建于 2026 年 11 月,最近一次推送在 2026 年 11 月 17 日,更新频繁。
  • 文档README 详细,含架构图、场景模板和插件说明,另有 INSTALL.md 和 SKILL.md。
  • 社区5740 星、1060 叉,仅 2 个开放 Issue,社区关注度较高。
  • 上手难度一条命令安装,规则用 JSON 配置,提供 try 命令快速验证,上手门槛较低。

使用前注意

  • · 需要 Node 24 或更新版本,以及已登录的命令行 Agent。
  • · 部分通道(如飞书)需配置公网可访问的 hub.publicUrl 才能接收回调。
  • · 内置 Agent 接第三方模型服务需自行写启动脚本设置环境变量。
  • · 部分模板和 Webhook 仅在本地模拟验证,未在真实账号或服务上完整跑过。

主题标签

ai-agentsautomationclaude-codeclicodexevent-drivenmcpnodejsself-hostedtypescriptworkflow