loopx

让 AI 智能体团队长时间稳定运行不掉链子

loopx 是一个轻量级的循环工程状态内核，专为长时间运行的 AI 智能体团队设计。它解决了编码智能体（如 Codex、Claude Code 等）在长时间任务中缺乏持久状态、目标易丢失、任务交接不清晰等问题。loopx 提供持久化目标、基于配额感知的自动唤醒、可执行的待办事项、证据日志和可验证的交接机制，使得智能体能够在多轮循环中保持稳定运行。其核心能力包括：与多种智能体框架无关的循环控制、状态持久化、任务分解与追踪、以及运行日志的审计。通过将循环状态外部化，loopx 增强了智能体的可靠性和可观测性，适用于复杂的自动化工作流。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5923

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队loopx-project

所属国家

官网地址https://loopx-project.github.io/loopx

GitHubhttps://github.com/huangruiteng/loopx

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agent-control-plane,agent-harness,agent-ops,ai-agents,codex,dsh-plugin,long-horizon,long-horizon-agents,loop-engineering,loopx,workflow-automation

GitHub 星标★ 5923

30天Star增速

HF 下载量

上线时间2026-05-31 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：本地安装 4 步

环境要求

已安装 git 并能访问 GitHub
具备可执行 shell 脚本的环境（安装脚本为 install-local.sh）
本地具备 Python 运行环境（项目开发语言为 Python）
有可读写的用户主目录，用于放置 ~/loopx 与 .loopx 状态

安装与启动步骤

1克隆仓库

按 README 给出的 clone 式安装路径，把仓库克隆到主目录下的 ~/loopx。
```
git clone https://github.com/huangruiteng/loopx ~/loopx
```
2运行安装脚本

执行仓库自带的本地安装脚本，用于注册 loopx 命令并准备本地运行状态。
```
~/loopx/scripts/install-local.sh
```
3自检环境

运行 doctor 检查，README 把 doctor 通过视为连接成功的标志之一。
```
loopx doctor
```
4查看循环状态

确认能看到当前目标、具体用户关口和下一个智能体待办，才算真正就绪。
```
loopx status
```

关键配置

配置项	必填	说明	示例
`.loopx/registry.json`	否	本地运行时状态注册表，用于持久化目标与循环状态	`/your/path/.loopx/registry.json`

如何确认成功

loopx doctor 通过；存在 .loopx/registry.json 与投影出的活跃目标状态；loopx status 显示目标、用户关口和下一步待办。

常见问题

Q：clone 式安装适合所有人吗？

A：README 明确说明 clone 式安装只面向想要 live canary wrapper 的贡献者；普通用户可先参考官网与文档，本教程只覆盖 README 给出的命令。

Q：loopx 会替换掉 Codex、Claude Code 吗？

A：不会。loopx 是运行在这些 agent harness 之上的状态内核与控制面，负责持久化目标、关口、待办、证据、配额与交接，具体工作仍由 harness 执行。

Q：怎么反馈第一次使用体验？

A：可提交 GitHub 的 first-run 反馈 issue；或用 loopx first-run-report 在本地打印同样的预填链接，不会发送任何数据。

Q：本地运行时状态要提交到仓库吗？

A：不要。README 把“本地运行时状态被忽略而不是被提交”列为成功连接的条件之一。

注意事项

README 只提供 clone 式安装命令，未给出 pip、Docker 等其他安装方式，请勿自行替换安装途径。
首次运行反馈完全可选、不含遥测，且不要附带日志、路径、凭证、内部项目名或目标内容。
安装脚本路径为仓库内的 scripts/install-local.sh，需在克隆完成后执行，确保脚本有可执行权限。
需要能看到一个可见的 loop driver 或明确的激活指令，否则循环不会真正跑起来。

核心亮点

提供持久化目标与待办事项，智能体不会遗忘任务
配额感知自动唤醒，节省资源且确保任务推进
证据日志与可验证交接，提升团队协作透明度

不足之处

文档/社区待观察
生态较新，与主流智能体框架集成深度待验证

适用场景

长时间运行的编码智能体任务管理
多智能体协作的复杂工作流自动化
需要审计和可追溯性的 AI 运维场景

替代项目

LangGraph、AutoGen、CrewAI

项目介绍

loopx 是智能体领域的开源项目，由 loopx-project 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（5,923）位列前 8%，在智能体分类的 2,517 个项目里位列前 8%。

近 41 天，它的 GitHub 星标从 4,393 增加到 5,923，净增 1,530。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：长时间运行的编码智能体任务管理。同类可对比的替代方案包括 LangGraph、AutoGen、CrewAI。

上一篇：Aegis

下一篇：ai-dive-deep