LoopX：长时程 Agent 的开源有状态控制平面

是控制平面，不是又一个 Agent 框架

LoopX 用一句话定义自己：面向长时程 agent 的开源、provider 中立、有状态控制平面。它跑在 Codex、Claude Code、Cursor 等 agent harness 之上而不替换它们，补上的正是这些 harness 缺失的一层：目标、门禁、待办、范围、证据、配额与交接，能够跨回合、跨重启、甚至跨不同 agent 持久保存。README 给出的心智模型是「面向长时程工作的 agent 原生看板」：卡片携带身份、权限、证据与续跑信息，每一次移动都是 claim、gate、monitor、writeback 这类经过校验的算子。

它的动机非常具体。单个会话内的任务 agent 可以做完，但多天级工作会以特定的方式失败：目标漂移、owner 决策中途出现、证据过期、工作在 peer agent 之间交接、调度器在没有有效状态迁移后继续烧配额。聊天记忆加定时器治理不了这些。LoopX 因此把持久控制状态收进一个紧凑内核，让 harness 只执行有界的工作切片。

内核的五个问题

架构被折叠成五个问题，每个问题对应一个跨 harness 的产品承诺：目标是什么（活跃 goal、显式 scope、当前权限）；下一步做什么（有序的用户与 agent 待办，含所有权、认领与租约）；什么需要人类判断（具体的用户门禁，而不是一句含糊的「等 owner」）；证据发生了什么变化（紧凑的运行历史、验证、阻塞与被接受的写回）；循环能否继续（配额、能力、安全回落、调度提示与停止条件）。危险权限、发布、生产写操作与最终所有权明确留在人类手里。

运行时契约同样明确。执行路径是 Agent 到 Capability 到 Provider；控制路径返回 Provider readback 到 Capability transition 到 Kernel。Capability 是稳定、provider 中立的契约，负责产出一个有界、可验证的结果；Provider 调用外部系统并返回观测与读回；Extension 则以显式的安装、启用、升级、禁用、回滚生命周期打包可选 provider。注册后的 agent 互为 peer：认领、租约、任务边界与类型化续跑决定下一个行动者，不需要持久的 leader 身份。

配额是治理者

最有辨识度的原语是配额。loopx quota should-run 回答「这个注册 agent 现在能不能动」，交互契约再决定这一回合该交付、该提问、该等待、该自修复还是保持安静。最小自定义运行时的一个 tick 只有五条命令：quota should-run、todo claim、todo update、refresh-state、quota spend-slot。这个极小的表面就是自定义 runner 需要的全部循环驱动，也正因如此，宿主表才能横跨 Codex App、Codex CLI、Claude Code、KunlunCode、OpenCode、Pi、ZCode、Antigravity CLI、DeepSeek Harness、Cursor 与纯 shell runner，而不必为每个宿主分叉一套治理逻辑。

证据优先于宣称

LoopX 对证据强度的态度异常谨慎。旗舰案例包括：200+ 小时的公开 OpenViking 贡献弧线（作者本人的 PR 序列，带滚动仓库上下文与带版本戳的修复知识）；一份脱敏的 200+ 小时 owner 自跑 AutoML 实验图，把假设、匹配证据、无效谱系与 promote/stop 门禁放在同一张图里；以及仓库内可复现的 exact-KNN 自动研究 demo，proposer、executor、evaluator/promoter 三类角色并行迭代。独立用户报告又补充了 13 小时 C++ 精度长跑、4 天无人值守运行、以及公开引擎重构的 7 个合并 PR；每个案例页都写明可复现边界，并明确否认连续算力或生产自治的宣称。

上手路径

安装是 pip install loopx 加 loopx workflow-skills --install 与 loopx doctor；然后在项目根目录 loopx connect，状态缺失时走引导式 loopx start-goal。要求 Python 3.11+ 与 Node 22.6+，后者用于托管的、空闲即退出的 TypeScript Effect 核心，由 LoopX 自动拉起。loopx dashboard 打开 local-first 的个人 Agent 工作台：目标、门禁、证据、定时 watch 与飞书路由的收件箱消息都在其中；浏览器只是投影，永远不是状态权威。随附的领域能力包括 issue 修复、变更质量判定、集成分支对账、探索、决策上下文与周期报告。Apache-2.0 许可，入库时约 5.7k star。