agent-autoloop

让命令行 Agent 后台自动接活干到底,拿不准才找你拍板

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 474 🐛 待处理 8 👀 关注 8
GitHub ↗
GitHub 星标 ★ 2359
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无官网定价信息

项目预览

agent-autoloop 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队KKKKhazix
定价模式🏷️完全免费
价格说明开源免费,无官网定价信息
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai-agents,automation,claude-code,cli,codex,event-driven,mcp,nodejs,self-hosted,typescript,workflow
GitHub 星标★ 2359
上线时间2026-11-03 00:00:00
代码更新2026-11-04
仓库体积882 KB
本站数据更新2026-11-05
维护状态活跃
收录时间2026-11-05
浏览次数0

项目介绍

agent-autoloop 是一个用 TypeScript 编写的命令行 Agent 自动化编排工具,目标是让 Claude Code、Codex 等 CLI 型 AI Agent 在后台持续接活并跟进到完成。它把原本需要人工反复触发的 Agent 会话改造成事件驱动的工作流:任务进入队列后由调度器自动分派给 Agent,执行过程、状态和产出被记录追踪,失败或中断可自动重试续跑。核心能力包括任务队列与调度、多 Agent 会话管理、基于 MCP 的工具接入、事件触发与回调,以及关键的人机协同机制——平时不打扰用户,只在 Agent 判断需要决策、权限或信息不足时推送确认卡片,由人拍板后继续。项目支持自托管,适合把重复性的代码修改、巡检、文档整理等任务交给后台 Agent 长跑,减少人工盯守和上下文切换成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-05 · 当前星标 ★ 2359

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • macOS 或 Linux 系统(Windows 暂不支持)
  • Node 24
  • Git 与 curl
  • 一个已登录好的命令行 Agent,如 Claude Code 或 Codex

安装与启动步骤

  1. 1检查基础环境

    先确认系统为 macOS/Linux,已安装 Node 24、Git、curl,并能正常调用一个已登录的命令行 Agent。

    node -v
    git --version
    curl --version
  2. 2安装 agent-autoloop

    执行官方安装脚本,自动下载并安装命令行工具,无需 GitHub 账号,也不需要云服务器。

    curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
  3. 3跑一遍真实试跑

    用本机 Agent 走完整链路:发出事件、Agent 执行、提问后退出等待回复,不占用进程。

    agent-autoloop try
  4. 4回答 Agent 的提问

    交互终端里直接输入数字回车;非交互终端用 answer 加任务序号和选项序号提交选择。

    agent-autoloop answer 1 2
  5. 5查看状态与统计

    确认 Agent 接回原会话继续完成任务,并查看今天和最近 7 天的轮数、Token 与费用。

    agent-autoloop status

如何确认成功

运行 agent-autoloop status,能看到 Agent 接上原会话并显示试跑通过,同时列出轮数、Token 与费用统计。

常见问题

Q:Windows 可以用吗?

A:目前仅支持 macOS 和 Linux,README 中说明 Windows 版本仍在开发与兼容性测试中,需等待正式发布。

Q:需要云服务器或开放公网端口吗?

A:不需要。装在自己的一台 Mac 或 Linux 电脑上,一条命令即可运行,也不用开放公网端口。

Q:Agent 提问后一直挂着进程吗?

A:不会。Agent 结束本轮后退出、不占进程也不消耗 Token,等你回答后再接回原会话继续执行。

Q:非交互环境怎么作答?

A:使用 agent-autoloop answer 任务序号 选项序号,例如选择第二个选项就执行 agent-autoloop answer 1 2。

Q:有网页后台可以看进展吗?

A:没有后台界面。需要拍板时通过通知卡片推送,查看全局进展用 agent-autoloop status 命令。

注意事项

  • 需提前登录好至少一个命令行 Agent,否则试跑无法执行。
  • 想省事可把 README 指向的 INSTALL.md 交给你的 Agent,让它代为安装。
  • 任务需要决策、权限或信息不足时会推送确认卡片,其余时间不会打扰你。

核心亮点

  • 事件驱动调度,任务可排队、自动分派并追踪状态,减少人工反复触发 Agent
  • 内置人机协同卡片机制,只在需要决策时打断用户,兼顾自动化与可控性
  • 支持 MCP 工具接入和自托管部署,可对接 Claude Code、Codex 等现有 CLI Agent

不足之处

  • 项目处于成长期,长期后台运行的稳定性与异常恢复能力仍需更多实践验证
  • 依赖外部 CLI Agent 与模型服务,配置链路较长,上手有一定门槛

适用场景

  • 把重复性的代码修改、依赖升级等任务丢给后台 Agent 自动执行
  • 定时巡检仓库或文档并自动生成整理结果
  • 夜间批量跑多步骤任务,遇到需要确认的环节再推送卡片给人决策

替代项目

n8n、Dify、Langflow

上一篇:mcp

下一篇:teardown

同类项目推荐

tampermonkey-scripts 开源

装上即用,AI聊天和论坛摸鱼效率翻倍

Greasemonkey、Tampermonkey scripts 油猴脚本集:AI chat全能助手、linux.do摸鱼...

★ 143 2026-08-09
invisible_playwright_mcp 开源

让 AI Agent 用隐身浏览器上网,绕过反爬和验证码

Playwright MCP server undetected by anti-bots and captchas: AI agent browses the web···

★ 882 2026-09-28
openwork 开源

用代码把零散任务串成自动流水线,少写重复脚本

★ 1459 2026-09-12
crawlee-python 开源

一套 API 搞定反爬、代理和动态页面,稳定抓数据喂给 AI。

Crawlee—A web scraping and browser automation library for Python to build reliable ···

★ 9643 2026-09-18
BrowserMCP 开源

让 AI 直接操作你已登录的 Chrome,免登录跑自动化

Connect MCP agents to your logged-in Chrome. Persistent JavaScript workspace, browse···

★ 127 2026-10-22
human-review 开源

像审阅文档一样给 AI 提反馈,让 AI 更懂你。

A visual tool to edit HTML and Markdown files, leave comments like a Google Doc, and···

★ 1445 2026-08-09
graphai 开源

用 YAML 画数据流图,自动跑多 Agent 工作流

GraphAI is an asynchronous data flow execution engine, which allows developers to bu···

★ 375 2026-10-18
dsh-bridge 开源

扫码或聊天软件,随时安全远程调用本地 DeepSeek

DeepSeek Harness 多通道远程访问与安全守护插件 | 局域网扫码直连、Cloudflare / 自建公网···

★ 245 2026-09-12
VideoAdGuard 开源

B站视频软广自动识别,一键跳过口播植入

哔哩哔哩浏览器插件:基于大语言模型,对B站视频中的植入广告进行检测。一键跳过视频中的植···

★ 767 2026-09-16