huangruiteng /loopx

Turn long-horizon goals into verifiable results. A local-first semantic control plane and research workbench for long-running agent teams, across sessions and runtimes.

★ 6,543⑂ 619👁 27▤ 276
PythonCreated 2026-05-31loopx-project.github.io/loopx/
+0
Daily
+0
Weekly
+284
Monthly
6,543
stars
619
forks
27
watchers
–
prs
–
issues
276
releases

README

LoopX 2.0



Turn long-horizon goals into verifiable results.

A local-first semantic control plane and research workbench for long-running agent teams, across sessions and runtimes.
Keep goals, decisions, ownership and evidence durable. Work with Codex, Claude Code, DeepSeek Harness and other runtimes you already use.

   

    

Get started · Why LoopX · See it in action · Evidence · Contribute · Docs · 简体中文



---



 Start in two steps

1. Install LoopX and its Agent skills. Requires Python 3.11+ and
Node.js 22.22.3+ (24 LTS recommended).

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


Install options and upgrades

2. Give your Agent a concrete task. Restart your Agent host, open your
project, then send this in Codex:

text
$loopx speed up this project's slowest workflow; compare approaches and verify the gains


Claude Code uses /loopx ; see host setup
for other runtimes. Prefer a guided first run? Choose a task below.

 📰 News



- 2026-10-25 · 🤝 Long-horizon agent research: collaborators welcome — Exploring breakthroughs in long-horizon outcomes under equal budgets, through feedback, replanning and reproducible evaluation on EdgeBench and real-world tasks. Academic labs and industry teams are welcome to collaborate, comparing outcomes and total cost. Discuss collaboration.
- 2026-10-20 · 🚀 LoopX 2.0 — A shared TypeScript control plane and long-horizon research workbench. Migration guide · Engineering story.
- 2026-10-14 · 🤖 Agentic software — Connecting goals, evidence and human feedback to engineering delivery.
- 2026-10-02 · 🧠 Long-horizon bootstrapping & 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 — A 46-task, same-model study provides empirical support for trading more compute for better outcomes: LoopX Heartbeat mean reward is 17.3% above Plain Codex and 10.6% above native Goal.
- 2026-09-06 · 🎉 LoopX 1.0 — A Personal Agent Workspace to follow agent work, act on decisions, and inspect delivered results across sessions. Workspace guide.
- 2026-08-02 · ⏱️ 200+ hour trajectories shared on X — 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.

All releases



 Why LoopX

An agent can finish a task in one session. Long-running work is harder:
objectives change, owner decisions appear, evidence goes stale, and agents
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
  artifacts, review and returned results while keeping responsibility explicit.
- Judge progress by what changed. Inspect deliverables, supporting and
  refuting evidence, costs and t

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON