Overview
LoopX describes itself as the open, provider-neutral, stateful control plane for long-horizon agents. It does not replace an agent harness — it sits above Codex, Claude Code, Cursor and others and holds the state they lose between turns: the objective, the gates it has to pass, the todo list, the evidence collected so far, the remaining quota, and the handoffs between whoever picks the work up next.
The core is a durable state kernel over goals, todos, claims, leases and evidence. Around it sit quota-aware scheduling and cross-turn continuation (so a run that is interrupted resumes instead of restarting), typed handoffs for peer coordination between agents, evidence-backed recovery with a safe fallback path, and a personal workspace dashboard for watching long-running work.
It installs as a Python package and connects to an existing project directory, with the Python core paired with Node components. LoopX is Apache-2.0 licensed from v0.4.8 onward; earlier releases were published under MIT terms.
What it does
- Durable state kernel for goals, todos, claims, leases and evidence that survives across sessions
- Quota-aware scheduling and cross-turn continuation so an interrupted run resumes rather than restarts
- Typed handoffs for coordinating peer agents on the same objective
- Evidence-backed recovery with a governed fallback path when a step fails
- Personal workspace dashboard for monitoring long-horizon work in progress
- Provider-neutral: runs on top of Codex, Claude Code and other agent runtimes rather than replacing them
Getting started
Install the package, install its workflow skills, then connect LoopX to the project you want an agent to work on.
Install and check the environment
loopx doctor verifies the local setup before you connect a project.
python3 -m pip install --upgrade loopx
loopx workflow-skills --install
loopx doctorConnect an existing project
Run connect from the project root; status then shows the goals, todos and claims LoopX is holding for it.
cd /path/to/your-project
loopx connect
loopx statusStart a long-running goal
The guided flow walks through defining an objective that outlives a single agent session.
loopx start-goal --guided --project . --goal-text "Your long-running objective"Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Keep a multi-day refactor or migration on track across many separate agent sessions
- Give two or more coding agents a shared objective with explicit handoffs instead of duplicated work
- Recover a long agent run after an interruption without losing the evidence already gathered
- Stay portable across harnesses when you do not want the state of your work locked into one vendor's tool
How LoopX compares
LoopX alongside other open-source multi-agent systems tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| TradingAgents | ★ 103k | LangGraph framework that mirrors a trading firm: LLM analyst, bull/bear researcher, trader and risk-management agents debate before a decision. For research, not advice. |
| Ruflo | ★ 70.9k | Agent meta-harness that wraps Claude Code and Codex with 100+ specialized agents, swarm coordination, vector memory, background workers and cross-machine agent federation. |
| MetaGPT | ★ 70.2k | A multi-agent framework that models a software company, assigning roles like product manager, architect, and engineer to generate code from a single prompt. |
| AutoGen | ★ 60.8k | Microsoft Research's framework for building applications where multiple agents converse with each other and with tools to solve tasks. |
| CrewAI | ★ 58.2k | A framework for assembling teams ('crews') of role-playing agents that divide tasks and collaborate to complete a goal. |
| AgentScope | ★ 30.9k | A framework for building multi-agent applications with message passing, visual debugging tools, and distributed execution. |
| OpenAI Agents SDK | ★ 29.2k | OpenAI's lightweight Python SDK for building multi-agent workflows using explicit handoffs, tools, and guardrails. |
| LoopX | ★ 5.7k | A provider-neutral control plane that keeps goals, todos, evidence and handoffs alive while agents work across many sessions |