Skip to content
38 changes: 31 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@

**Turn long-horizon goals into verifiable results.**

A local-first control plane and research workbench for agents and teams.<br>
<sub>Keep goals, decisions, ownership and evidence across sessions. Work with the runtimes you already use: Codex, Claude Code, DeepSeek Harness and others.</sub>
A local-first [semantic control plane](https://loopx-project.github.io/loopx/blog/from-one-shot-agents-to-long-horizon-control/#control-plane) and [research workbench](#research-workbench) for long-running agent teams, across sessions and runtimes.<br>
<sub>Keep goals, decisions, ownership and evidence durable. Work with Codex, Claude Code, DeepSeek Harness and other runtimes you already use.</sub>

[![Release](https://img.shields.io/github/v/release/loopx-project/loopx?color=brightgreen)](https://github.com/loopx-project/loopx/releases/latest) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![TypeScript core](https://img.shields.io/badge/core-TypeScript-3178C6?logo=typescript&logoColor=white)](docs/architecture/rfcs/typescript-control-plane-migration-v0.md) [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](pyproject.toml)

Expand Down Expand Up @@ -37,6 +37,24 @@ $loopx speed up this project's slowest workflow; compare approaches and verify t

Claude Code uses `/loopx <complex task>`. [Other hosts, install options and upgrades ↓](#try-loopx)

## 📰 News

<!-- Curate major product/architecture releases, research findings, consequential
engineering lessons and substantive community milestones. Each needs a public
source and a distinct reader takeaway; version bumps or PR merges alone are
not news. Keep both languages aligned, newest first, using verified publication
dates (UTC). -->

- **2026-10-20 · 🚀 [LoopX 2.0](https://github.com/loopx-project/loopx/releases/tag/v2.0.0)** — A shared TypeScript control plane and long-horizon research workbench. [Migration guide](docs/product/releases/v2.0.0.md) · [Engineering story](https://loopx-project.github.io/loopx/blog/typescript-control-plane-refactor/).
- **2026-10-14 · 🤖 [Agentic software](https://loopx-project.github.io/loopx/blog/semantic-software-development/)** — Connecting goals, evidence and human feedback to engineering delivery.
- **2026-10-05 · 📊 [Evidence-driven research on EdgeBench](https://loopx-project.github.io/loopx/blog/edgebench-feedback-and-memory/)** — Studies of feedback, continuation, replanning and context cost, separating observed system progress from still-unproven mechanism gains.
- **2026-10-02 · 🧠 [Long-horizon bootstrapping & RSI](https://loopx-project.github.io/loopx/blog/long-horizon-rsi/)** — Four months of developing LoopX with LoopX: public project history and a design perspective on system-level self-improvement.
- **2026-09-18 · 🧪 [LoopX × LHTB](https://loopx-project.github.io/loopx/benchmarks/lhtb/)** — A 46-task long-horizon agent study comparing Plain Codex, native Goal and LoopX Heartbeat, with task-level results, methodology and comparison limits.
- **2026-09-06 · 🎉 [LoopX 1.0](https://github.com/loopx-project/loopx/releases/tag/v1.0.0)** — A Personal Agent Workspace to follow agent work, act on decisions, and inspect delivered results across sessions. [Workspace guide](https://github.com/loopx-project/loopx/blob/v1.0.0/docs/guides/personal-workspace-user-guide.md).
- **2026-08-02 · ⏱️ [200+ hour trajectories shared on X](https://x.com/huangruiteng/status/2083904257494024425)** — Early owner-run examples spanning 200+ elapsed hours drew broad attention on X, showing work across execution, waits, human decisions and recovery. [Trajectories and limits](#open-source-issue-fix).

[All releases](https://github.com/loopx-project/loopx/releases)

<a id="how-it-works"></a>

## Why LoopX
Expand All @@ -47,14 +65,16 @@ hand work to peers. A timer can keep a loop running without making it useful.

- **Continue without starting over.** Keep the Goal, accepted requirements,
decisions and evidence across sessions and restarts.
- **Coordinate without losing ownership.** Connect delegated work, dependent
- **[Coordinate without losing ownership.](https://loopx-project.github.io/loopx/blog/agent-facing-kanban/#walkthrough)** Connect delegated work, dependent
artifacts, review and returned results while keeping responsibility explicit.
- **Judge progress by what changed.** Inspect deliverables, supporting and
refuting evidence, costs and the next decision—not just activity.

Your Agent runtime supplies the model and tools. LoopX carries durable
control state for long-horizon agents and personal agent teams across
engineering, research and operations. Human authorization still governs protected actions.
Your Agent runtime supplies the model and tools. LoopX’s semantic control plane
preserves goals, acceptance, decisions, ownership and evidence across sessions
and runtimes for engineering, research and operations. Agents and people use
those facts to reassess what to do next. Human authorization still governs
protected actions.

<a id="learn-loopx"></a>

Expand Down Expand Up @@ -612,8 +632,10 @@ long-running agent ecosystem. Our confirmed partners include:
- [NoKV](https://github.com/NoKV-Lab/NoKV) - AI native distributed file system

<a id="loopx-20-1"></a>
<a id="whats-new-in-20"></a>

## What's New in 2.0
<details>
<summary>2.0 background and migration</summary>

| A shared control plane | A long-horizon research workbench |
| --- | --- |
Expand All @@ -624,6 +646,8 @@ long-running agent ecosystem. Our confirmed partners include:
Review the [migration and recovery guide](docs/product/releases/v2.0.0.md) before
continuing those Goals. Installation does not silently convert existing state.

</details>

## Advanced Paths

The first useful loop does not require every optional surface. Add these only
Expand Down
35 changes: 29 additions & 6 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@

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

面向 Agent 与团队的本地优先控制面和研究工作台。<br>
<sub>跨会话保留目标、决策、分工与证据,连接你已经在用的 Codex、Claude Code、DeepSeek Harness 等运行时。</sub>
面向长程 Agent 团队的本地优先[语义控制面](https://loopx-project.github.io/loopx/blog/zh/from-one-shot-agents-to-long-horizon-control/#control-plane)与[研究工作台](#research-workbench),跨会话、跨运行时延续工作。<br>
<sub>持久保留目标、决策、分工与证据,连接你已经在用的 Codex、Claude Code、DeepSeek Harness 等运行时。</sub>

[![Release](https://img.shields.io/github/v/release/loopx-project/loopx?color=brightgreen)](https://github.com/loopx-project/loopx/releases/latest) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![TypeScript core](https://img.shields.io/badge/core-TypeScript-3178C6?logo=typescript&logoColor=white)](docs/architecture/rfcs/typescript-control-plane-migration-v0.zh-CN.md) [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](pyproject.toml)

Expand Down Expand Up @@ -37,17 +37,36 @@ $loopx 优化这个项目最慢的流程,对比方案并验证性能提升

Claude Code 使用 `/loopx <复杂任务>`。[其他宿主、安装方式与升级说明 ↓](#试用-loopx)

## 📰 最新动态

<!-- Curate major product/architecture releases, research findings, consequential
engineering lessons and substantive community milestones. Each needs a public
source and a distinct reader takeaway; version bumps or PR merges alone are
not news. Keep both languages aligned, newest first, using verified publication
dates (UTC). -->

- **2026-10-20 · 🚀 [LoopX 2.0](https://github.com/loopx-project/loopx/releases/tag/v2.0.0)** — 共享 TypeScript 控制面与长程研究工作台。[迁移指南](docs/product/releases/v2.0.0.md#中文指南) · [重构历程](https://loopx-project.github.io/loopx/blog/zh/typescript-control-plane-refactor/)。
- **2026-10-14 · 🤖 [Agentic Software](https://loopx-project.github.io/loopx/blog/zh/semantic-software-development/)** — 连接目标、证据、人的反馈与工程交付。
- **2026-10-05 · 📊 [EdgeBench:证据驱动的长程研究](https://loopx-project.github.io/loopx/blog/zh/edgebench-feedback-and-memory/)** — 研究反馈、持续执行、重规划与上下文成本,区分观察到的系统进展与尚待验证的机制收益。
- **2026-10-02 · 🧠 [长程自举与 RSI](https://loopx-project.github.io/loopx/blog/zh/long-horizon-rsi/)** — 回顾用 LoopX 开发 LoopX 的四个月公开历史,讨论长程连续性如何支撑系统级自我改进。
- **2026-09-18 · 🧪 [LoopX × LHTB](https://loopx-project.github.io/loopx/benchmarks/lhtb/?lang=zh)** — 46 个长程任务的 Agent 对照研究:比较 Plain Codex、原生 Goal 与 LoopX Heartbeat,公开逐任务结果、方法与适用边界。
- **2026-09-06 · 🎉 [LoopX 1.0](https://github.com/loopx-project/loopx/releases/tag/v1.0.0)** — 个人 Agent 工作区:跨会话跟进 Agent 工作、处理待决事项、核对交付结果。[工作区指南](https://github.com/loopx-project/loopx/blob/v1.0.0/docs/guides/personal-workspace-user-guide.md)。
- **2026-08-02 · ⏱️ [200+ 小时长程轨迹在 X 公开分享](https://x.com/huangruiteng/status/2083904257494024425)** — 早期 owner-run 案例跨越 200+ 小时自然时长,展示执行、等待、人工决策与恢复的衔接,并在 X 获得广泛传播。[轨迹与边界](#开源-issue-fix)。

[全部发布记录](https://github.com/loopx-project/loopx/releases)

## 为什么需要 LoopX

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

- **接着做,不必重头交代。** 目标、已接受要求、决策与证据跨会话、跨重启保留。
- **分工协作,责任始终清楚。** 串起委派、依赖产物、独立评审与结果返回,保留每个 Agent 的工作归属。
- **[分工协作,责任始终清楚。](https://loopx-project.github.io/loopx/blog/zh/agent-facing-kanban/#walkthrough)** 串起委派、依赖产物、独立评审与结果返回,保留每个 Agent 的工作归属。
- **看成果和依据,而不只看活动。** 检查交付物、支持与反驳证据、成本,以及下一步决策。

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

<a id="学习-loopx"></a>

Expand Down Expand Up @@ -546,8 +565,10 @@ LoopX 欢迎与其他开源项目协作,共建长程 Agent 生态。已确认
- [NoKV](https://github.com/NoKV-Lab/NoKV) - AI 原生分布式文件系统

<a id="loopx-20-1"></a>
<a id="20-新变化"></a>

## 2.0 新变化
<details>
<summary>2.0 背景与迁移</summary>

| 共享控制面 | 长程研究工作台 |
| --- | --- |
Expand All @@ -558,6 +579,8 @@ LoopX 欢迎与其他开源项目协作,共建长程 Agent 生态。已确认
继续这些 Goal 前先看[迁移与恢复指南](docs/product/releases/v2.0.0.md#中文指南);
安装新版不会静默转换既有状态。

</details>

## 进阶路径

第一次有用的 Loop 不依赖全部可选能力。只有工作真正需要时再开启这些路径。
Expand Down
Loading