LoopX: Control Plane Cho AI Agent Chạy Dài Hạn

LoopX Là Gì?

LoopX là một state kernel viết bằng Python, đóng vai trò control plane chạy local cho công việc AI agent chạy dài hạn. Nó theo dõi phần bền vững của một job — objective, gate, todo, evidence và quota — trong một lớp state duy nhất trên máy bạn, để Codex, Claude Code, Cursor, hay một runtime tự viết đều đọc và ghi cùng một state. README gọi đây là Kanban dành riêng cho agent, nơi state của LoopX là nguồn sự thật.

Thách Thức Của Công Việc AI Agent Chạy Dài Hạn

Một agent có thể hoàn thành một tác vụ trong một lượt chạy. Nhưng công việc kéo dài nhiều ngày lại khác: mục tiêu thay đổi giữa chừng, evidence trở nên lỗi thời, agent này bàn giao việc cho agent khác, và một scheduler chạy theo giờ vẫn có thể tiếp tục kích hoạt turn dù không còn bước nào đáng làm — chat history và một cái timer không theo dõi được những chuyện đó. Cách tiếp cận của LoopX khá hẹp: nó không cố làm agent thông minh hơn, mà giữ objective, gate đang chặn tiến độ, danh sách todo, evidence và quota còn lại trong một chỗ duy nhất, để một session mới, hoặc một công cụ khác, có thể tiếp tục đúng chỗ session trước dừng lại.

Năng Lực Cốt Lõi Cho Agent Orchestration

• ✓State bền vững nằm trong `.loopx/` và `.codex/goals/` ngay trên máy bạn, không nằm trong chat context, nên nó sống sót qua việc kết thúc session hay đổi runtime.
• ✓`loopx quota should-run` quyết định một turn nên deliver, hỏi, chờ, tự sửa hay im lặng trước khi tốn bất kỳ quota nào, còn `loopx quota spend-slot` chỉ tính chi phí sau khi một slice đã hoàn thành và được validate.
• ✓Gate cụ thể thay cho trạng thái chờ mơ hồ — `loopx status` báo objective hiện tại, gate chính xác đang chặn tiến độ, và todo tiếp theo của agent.
• ✓`loopx todo claim` và `loopx todo update` cho các peer agent cách nhận một phần việc và bàn giao kèm evidence, thay vì dựa vào một leader ngầm định.
• ✓Cầu nối runtime bao phủ Codex App, Codex App qua SSH, Codex CLI, Claude Code (qua adapter opt-in với `/loopx` và `/loop`), và OpenCode (qua command facade).
• ✓Các domain capability được đóng gói thành command cho những lane việc lặp lại — `loopx issue-fix`, `loopx content-ops`, `loopx value-connectors`, `loopx ml-experiment`, `loopx benchmark`.
• ✓`loopx review-packet` dựng một bản tóm tắt gọn, hướng tới owner, về quyết định, evidence và gate còn tồn đọng — dành cho người không đọc raw output của agent.
• ✓Các projection tùy chọn như Lark Kanban adapter và dashboard local hiển thị state mà không trở thành nguồn sự thật thay cho LoopX.

Khi Nào Nên Dùng LoopX

• •Công việc engineering, research, benchmark hay experiment kéo dài nhiều ngày, chạy qua nhiều session agent riêng biệt.
• •Các loop issue và PR cần giữ nguyên scope, evidence và review state xuyên suốt nhiều turn và nhiều công cụ.
• •Các job heartbeat hay monitor lặp lại, cần dừng tốn compute khi không còn bước tiếp theo nào hữu ích.
• •Dự án có gate về phê duyệt của owner, an toàn, publish, hay dữ liệu riêng tư, cần một điểm dừng-và-hỏi rõ ràng.
• •Setup nhiều peer agent, nơi việc claim task, lease và bàn giao giữa các agent quan trọng hơn một chat dài đơn lẻ.

Bắt Đầu Với LoopX

Phần cài đặt được tài liệu hóa rõ ràng. LoopX cần Python 3.11+, `curl`, `tar`, và một shell macOS hoặc Linux — Git chỉ cần cho đường cài đặt dành cho contributor qua clone, còn bản thân package Python không có runtime dependency nào ngoài standard library. Đường cài đặt chính không cần clone repo: pipe script cài đặt từ repo, thêm binary vào `PATH`, rồi chạy kiểm tra doctor. ```bash curl -fsSL https://raw.githubusercontent.com/huangruiteng/loopx/main/scripts/install-from-github.sh | bash export PATH="$HOME/.local/bin:$PATH" loopx doctor ``` Từ thư mục gốc project, `loopx connect` rồi `loopx status` sẽ gắn LoopX vào project đó. Nếu nó báo thiếu state, đường dẫn có hướng dẫn (`loopx start-goal --guided --project . --goal-text "Your long-running objective"`) sẽ tạo state mới. LoopX được thiết kế để tái sử dụng state có sẵn thay vì ghi đè, và README khuyến nghị giữ `.loopx/`, `.codex/goals/`, và `.local/` ngoài version control. Contributor muốn dùng bản canary chạy trực tiếp thì clone repo và chạy `scripts/install-local.sh`.

Tích Hợp LoopX Với AI Agent Của Bạn

Sau khi connect, cách tích hợp thật sự phụ thuộc vào runtime agent bạn đang dùng. Riêng với Claude Code, README trỏ tới một adapter opt-in — cài nó vào, rồi chạy `/loopx <task>` tiếp theo là `/loop`, khi đó loop driver chính là lệnh `/loop` gốc của Claude Code nhưng được LoopX gate lại. Codex App, Codex CLI và OpenCode mỗi cái đều có start command và loop driver riêng trong bảng host của README, còn Cursor hay một runner tự viết có thể gọi LoopX trực tiếp qua installer và `loopx doctor`. Bên dưới tất cả các trường hợp đó, core tick mà LoopX kỳ vọng một runtime chạy qua là năm command: `loopx quota should-run`, `loopx todo claim`, `loopx todo update`, `loopx refresh-state`, `loopx quota spend-slot`. Một kết nối hoạt động đúng sẽ có `loopx doctor` pass, `.loopx/registry.json` có dữ liệu, và `loopx status` hiển thị objective, gate và todo tiếp theo thật sự — thiếu phần nào trong số đó nghĩa là setup chưa xong.

Câu Hỏi Thường Gặp

Các Lựa Chọn Thay Thế

Nên Dùng LoopX Khi Nào — Và Khi Nào Nên Bỏ Qua

Nên thử LoopX nếu bạn đã chạy Codex, Claude Code hay Cursor cho công việc kéo dài nhiều ngày thay vì vài phút — sửa issue, chạy research loop, monitor lặp lại — và đã chán việc phải giải thích lại state mỗi khi session reset. Nên bỏ qua nếu tác vụ agent của bạn xong gọn trong một lượt chạy, hoặc nếu bạn cần một sản phẩm hosted hoàn chỉnh thay vì một công cụ local, MIT-licensed, vẫn còn ở giai đoạn sớm mà bạn phải tự chạy và tự đọc.

Repo liên quan