에이전트가 단일 대화 세션에서 가벼운 과제를 처리하는 것을 넘어, 며칠에 걸친 리서치·엔지니어링·PR 수정 과제를 수행할 때 가장 큰 걸림돌은 **‘상태 지속성(Statefulness)‘과 ‘가버넌스 통제’**입니다. 작업 중 목표가 바뀌거나, 사람의 판단/승인이 필요하거나, 토큰 사용량이 폭증하는 문제를 챗봇의 단기 대화 기억(Context Window)에만 의존해 해결하기는 불가능합니다.
LoopX(huangruiteng/loopx)는 기존 에이전트 런타임(Codex, Claude Code, Cursor 등)을 대체하지 않고, 그 위에서 과제의 진행 상태와 게이트를 로컬 퍼스트 칸반(Kanban) 방식으로 가버닝해 주는 프레임워크 중립적 제어 커널(Stateful Control Plane)입니다.
Sources
1. LoopX가 해결하려는 핵심 과제
에이전트가 긴 호흡으로 며칠씩 작업할 때 발생하는 주요 문제입니다:
- 에이전트 런타임이 무한 루프를 돌며 유용하지 않은 시도에 비용(토큰)을 지속 소모함.
- 중요한 생산 환경 변경이나 비가역적 액션에 대해 인간의 승인(Gate)을 거치지 않음.
- 여러 에이전트(Peer Agents)가 작업을 주고받을 때 상태와 생성된 증거(Evidence)의 파편화 발생.
LoopX는 이러한 제어 상태(Control State)를 압축하여 소유권, 할 일, 승인 게이트, 토큰 쿼터를 일관되게 관리합니다:
Objective / Issue / Project
│
▼
LoopX State: Objective + Gates + Todos + Scope + Evidence + Quota
│
├─ Human judgment needed? ── YES ─▶ Ask a concrete question and wait
│
├─ Safe fallback available? ──────▶ Run one bounded agent slice
│
▼
Codex / Claude Code / Cursor / Shell agent executes one turn
│
▼
Write evidence + Handoff + Next todo ─▶ Quota decides the next tick
2. 주요 구조 및 5대 메커니즘
LoopX는 컨트롤 플레인의 상태를 다음과 같은 5가지 핵심 요소로 정제합니다:
| 구분 | 주요 관리 요소 |
|---|---|
| Objective | 활성화된 최종 목표(Active Goal), 명시적 작업 범위(Scope), 권한 |
| Todos | 사용자 및 에이전트의 순차적 할 일 목록, 작업 점유(Claim) 및 임대(Lease) |
| Gates | 막연한 대기가 아닌, 인간의 명확한 승인/판단이 필요한 구체적 개입 조건 |
| Evidence | 실행 이력, 검증 결과, 블로커, 수용된 수정을 기록하는 콤팩트한 런 히스토리 |
| Quota & Steering | 에이전트 턴을 실행(Tick)할지 여부를 결정하는 토큰 쿼터 및 스케줄러 힌트 |
3. 에이전트 런타임 브릿지 (Runtime Bridges)
LoopX는 독립된 프레임워크가 아닌 에이전트 네이티브 게이트키퍼로 동작합니다:
- Claude Code:
/loopx <task>및/loop명령어 어댑터 지원 - Codex CLI & App: 쿼터 힌트에 기반한 샌드박스 턴 발주 및 백그라운드 하트비트 연동
- Pi, OpenCode, Cursor: CLI 및 스킬 명령어를 통해 상태 조회 및 업데이트 연동
4. 로컬 퍼스트 설치 및 런타임 지원
Python 3.11+ 환경의 마코스(macOS) 및 리눅스(Linux) 쉘에서 표준 라이브러리 기반으로 작동하며, 외부 종속성 없이 1줄 스크립트로 동작합니다:
# 설치 및 연결
curl -fsSL https://raw.githubusercontent.com/huangruiteng/loopx/main/scripts/install-from-github.sh | bash
export PATH="$HOME/.local/bin:$PATH"
cd /path/to/your-project
loopx connect
loopx status
LoopX는 장시간 동작하는 AI 에이전트 팀이 통제를 벗어나지 않고 검증 가능한 결과물(Evidence)을 축적할 수 있도록 돕는 매우 인상적인 오픈소스 컨트롤 플레인 툴입니다.