README

LoopX 2.0



让 Agent 把长程目标做成可验证的成果。

面向长程 Agent 团队的本地优先语义控制面与研究工作台，跨会话、跨运行时延续工作。
持久保留目标、决策、分工与证据，连接你已经在用的 Codex、Claude Code、DeepSeek Harness 等运行时。

   

    

快速上手 · 为什么需要 LoopX · 看看实际使用 · 证据与案例 · 参与贡献 · 文档 · English



---



 两步开始

1. 安装 LoopX 和 Agent 技能。 需要 Python 3.11+、Node.js 22.22.3+（推荐 24 LTS）。

bash
python3 -m pip install --upgrade loopx && loopx workflow-skills --install


其他安装方式与升级说明

2. 给 Agent 一个具体任务。 重启 Agent 宿主，打开项目，再在 Codex 对话中输入：

text
$loopx 优化这个项目最慢的流程，对比方案并验证性能提升


Claude Code 使用 /loopx ；其他运行时见宿主接入。
想跟着教程试一次？选择一个入门任务。

 📰 最新动态



- 2026-10-25 · 🤝 长程 Agent 研究：欢迎学术与企业合作者 — 探索等预算下的长期效果突破：围绕 EdgeBench 和真实长程任务，研究反馈、重规划与可复现评测，同时核对效果与完整成本。欢迎学术与企业团队合作。交流合作。
- 2026-10-20 · 🚀 LoopX 2.0 — 共享 TypeScript 控制面与长程研究工作台。迁移指南 · 重构历程。
- 2026-10-14 · 🤖 Agentic Software — 连接目标、证据、人的反馈与工程交付。
- 2026-10-02 · 🧠 长程自举与 RSI — 回顾用 LoopX 开发 LoopX 的四个月公开历史，讨论长程连续性如何支撑系统级自我改进。
- 2026-09-18 · 🧪 LoopX × LHTB — 46 个长程任务、同一模型的对照研究，为“计算换效果”提供实证支持：LoopX Heartbeat 平均 Reward 较 Plain Codex 提升 17.3%、较原生 Goal 提升 10.6%。预算不同，方法与适用边界公开。
- 2026-09-06 · 🎉 LoopX 1.0 — 个人 Agent 工作区：跨会话跟进 Agent 工作、处理待决事项、核对交付结果。工作区指南。
- 2026-08-02 · ⏱️ 200+ 小时长程轨迹在 X 公开分享 — 早期 owner-run 案例跨越 200+ 小时自然时长，展示执行、等待、人工决策与恢复的衔接，并在 X 获得广泛传播。轨迹与边界。

全部发布记录

 为什么需要 LoopX

一个 Agent 可以在单次会话里完成任务。长程工作更难：目标会变化，用户决策会出现，
证据会过期，多个 Agent 会交接。定时器能让任务继续运行，却不能保证仍在做有用的工作。

- 接着做，不必重头交代。 目标、已接受要求、决策与证据跨会话、跨重启保留。
- 分工协作，责任始终清楚。 串起委派、依赖产物、独立评审与结果返回，保留每个 Agent 的工作归属。
- 看成果和依据，而不只看活动。 检查交付物、支持与反驳证据、成本，以及下一步决策。

模型与工具由你的 Agent 运行时提供。LoopX 的语义控制面跨会话、跨运行时保留目标、
验收条件、决策、分工与证据，支撑工程、研究与运营中的持续协作。Agent 与人据此
重新判断下一步；受保护操作仍须遵守人类授权。



| 你想做什么 | 从这里开始 |
| --- | --- |
| 让编程或研究 Agent 跨会话持续干活 | 安装并开始 |
| 在一个入口管理个人项目、定时任务与待决事项 | 个人 Agent 工作区 |
| 让多个 Agent 分工协作，交付可验收的结果 | Agent 协作指南 |

LoopX 把长期控制状态留在同一层紧凑状态里：


  
  


Agent runtime 负责执行，LoopX 负责治理跨运行延续的控制状态，让工程、
研究、discovery 和运营 Loop 能持续推进。它不是又一个 agent framework，也不是
绑定某一 Provider 的编排 runtime。


  
  



控制面如何工作，适合哪些场景

一个形象化理解是：LoopX 是
面向长程 Agent 的可执行看板。
卡片带有稳定身份、权限、证据和 continuation；移动卡片要经过 claim、gate、
monitor、validate、writeback 等 typed operator。看板是 projection，LoopX state
才是事实源。

注册 agent 彼此平级。todo claim、lease、任务边界、能力门和 typed continuation
共同决定下一步谁执行，不需要一个长期拥有全局权限的 leader agent。

LoopX 适合：

- 多天或多周的工程、研究、benchmark、实验目标；
- 需要跨轮保留 scope、证据和 review 状态的 issue / PR Loop；
- recurring heartbeat 或 monitor-style agent 工作；
- 带 owner、安全、发布或私有数据 gate 的项目；
- 需要 ownership、lease 和 handoff 的平级 agent team；
- 需要把进展、阻塞和反馈入口清晰呈现给非技术用户的创作、研究或运营工作。

LoopX 不是生产自动化控制器。危险权限、生产写入、公开发布和最终 ownership
仍由人类负责。



 看看 LoopX 如何工作


观看研究工作台影片 · 86秒 · 双语文字稿、字幕与来源。App 实录、合成示例与机制示意分别标注。



 让研究接得下去

打开 Goal 查看任务归属、Agent 与已记录的 Explore 历史。通过 深度分析 / Deep analysis
检查已登记轨迹的引用、原生结果读回，以及单独测量的成本。Agent 准备来源；
打开页面、刷新和读取结果不会启动模型，执行分析需要显式操作及已配置的宿主和账号。

保留支持、反驳与未知，核对新证据为什么改变了路线，或为什么值得继续，再进入下一轮。

 认识个人 Agent 工作区

把长程目标收进同一个 local-first 工作区。Goal、待关注事项、对话、任务、
文件、定时计划与恢复状态跨天数、跨重启、跨 harness 保持持久。重新打开项目时，
可以检查上一轮的状态与证据，再继续下一项允许执行的工作。

LoopX 将这些长程控制状态汇入 Personal Workspace。你可以在一个页面中：

- 看清哪些事项正在等你、执行中、观察中、已安排或已停止；
- 配置 Goal 的 Capability，区分机器默