loopx-project/loopx

LoopX – 長期 AI 代理人的狀態化控制平面

是什麼 – LoopX 是一個開源、與提供者無關的「控制平面」，位於現有的 LLM 代理執行環境（Codex、Claude Code、Cursor 等）之上。它儲存多回合、多日工作流程的持久狀態——目標、關卡、待辦事項、證據、配額與交接，並決定下一個應由哪個代理執行。簡而言之，它將一系列孤立的代理呼叫轉換為可審查、可重啟、有人類參與的循環。

為何重要 – 現代 LLM 代理在完成單一任務方面表現出色，但長期專案（研究實驗、多日工程、持續監控）需要：

• 可在重啟後持續的持久上下文
• 明確的人類審核點
• 安全的回退機制與配額限制
• 清晰的審計軌跡（做了什麼、為什麼、依據什麼證據） LoopX 在不取代底層代理框架的前提下提供這些能力。

核心概念

概念	作用
目標 / 目的	循環的高階目標（例如：「訓練一個模型兩週」）
關卡	必須經由人類或策略驅動的檢查點審核後才能進入下一階段
待辦事項	代理可領取並執行的有界工作項目
證據	每回合產生的檔案、日誌或工件，以不可變方式儲存，供後續審查
配額	限制可執行的回合數量，防止失控執行
交接	責任結構化地轉移給另一個代理或人類

如何運作 – 循環流程如下：

目標 → LoopX 狀態（目標、關卡、待辦事項、證據、配額）
   ├─ 若需人類判斷 → 提出具體問題，等待
   ├─ 否則若存在安全回退 → 執行有界代理片段
   ▼
代理執行環境（Codex、Claude Code 等）執行一回合
   ▼
LoopX 記錄證據，更新狀態，決定下一回合

狀態儲存在本地（「本地優先」工作區），是唯一真相來源；代理執行環境僅作為工作者存在。

主要功能

• 個人工作區 – 本地優先的 UI（瀏覽器/PWA 或原生桌面），可在重啟後持續顯示目標、待辦任務、日程和證據。
• 提供者無關適配器 – 支援 Codex App、Claude Code、Cursor、KunlunCode、DeepSeek Harness 和通用 shell 執行器的外掛。
• 人機協同審核 – 明確的審核步驟、類型化預覽和狀態變更前的收據。
• 跨執行環境連續性 – 專案中途可從 Codex 切換到 Claude Code 而不遺失狀態。
• 審計就緒的證據圖 – 每回合輸出版本化並可視化為任務圖。
• 可擴展的技能/命令介面 – 可在各種 IDE 和聊天平台中透過 /loopx 命令暴露 LoopX。
• 基準測試與案例研究 – SWE-Marathon、LHTB、自動機器學習、開源問題修復示範，展示超過 200 小時的循環。

技術堆疊

• 核心 – 控制平面伺服器使用 TypeScript（Effect 執行時）；Python 3.11+ 客戶端程式庫和 CLI。
• 儲存 – 基於本地檔案系統的「本地優先」儲存（.loopx/ 目錄）。
• UI – 瀏覽器端儀表板（PWA）及可選的 macOS/Windows 原生桌面建構。
• 打包 – 透過 PyPI（pip install loopx）和 npm（TypeScript 核心）分發。

典型用例

• 需要定期人類審查的多日研究或工程實驗。
• 必須保留上下文、證據和決策鏈的缺陷修復或 PR 工作流。
• 持續運行數週的監控或心跳任務。
• 所有權、租約和交接明確的代理團隊。
• 任何長期自動化任務，其中人類操作員必須對關鍵操作保持控制。

快速上手

# 安裝 Python 套件（包含 CLI 和 TypeScript 執行時）
python3 -m pip install --upgrade loopx
# 安裝內建工作流程技能（代理、適配器等）
loopx workflow-skills --install
# 驗證安裝
loopx doctor

# 將專案連接到 LoopX
cd /path/to/your/project
loopx connect   # 若缺失則建立 .loopx/ 狀態
loopx status    # 顯示目前目標、關卡、待辦事項

# 啟動新長期目標（引導式向導）
loopx start-goal --guided --project . --goal-text "訓練一個情感模型 10 天"

之後可透過 loopx dashboard 啟動儀表板，或透過提供的適配器（如 codex、claude、cursor）執行代理。

成熟度 – 倉庫已發布 1.0 版本，提供桌面預覽和不斷增長的整合。文件包含雙語開發者手冊、詳細指南和展示目錄。專案積極維護（Discord 社群、定期發佈），並標記為「loop agents active」。

了解更多

• 網站 / 文件 – https://loopx-project.github.io/loopx/
• 開發者手冊 – https://loopx-project.github.io/loopx/docs/book/en/
• Discord – https://discord.gg/XmGgQyCFZd
• 基準測試與案例研究 – 請參閱 README 的「Evidence」部分。

---

以上所有資訊均直接取自倉庫的 README，未添加任何外部推測。