loopx-project/loopx

LoopX – 장기적 AI 에이전트를 위한 상태 기반 제어 플레인

무엇인가요 – LoopX는 기존 LLM 에이전트 런타임(Codex, Claude Code, Cursor 등) 위에 배치되는 오픈소스이자 프로바이더에 종속되지 않는 "제어 플레인"입니다. 다중 턴, 다일간 워크플로우의 지속 가능한 상태(목표, 게이트, 할 일, 증거, 할당량, 인수인계)를 저장하고 다음에 어떤 에이전트가 행동할지 결정합니다. 간단히 말해, 고립된 에이전트 호출을 검토 가능하고 재시작 가능한, 인간이 개입하는 루프로 전환합니다.

왜 중요한가요 – 현대의 LLM 에이전트는 단일 작업을 완수하는 데 뛰어나지만, 장기적인 프로젝트(연구 실험, 수일간의 엔지니어링, 지속적인 모니터링)에는 다음 요소가 필요합니다:

• 재시작 후에도 유지되는 지속적인 컨텍스트
• 명시적인 인간 승인 지점
• 안전한 백업 및 할당량 제한
• 명확한 감사 추적(무엇이 수행되었는지, 왜, 어떤 증거로) LoopX는 하위 에이전트 허브를 대체하지 않고도 이러한 요소를 제공합니다.

핵심 개념

개념	역할
목표 / 목적	루프의 고수준 목적(예: 2주간 모델 훈련하기)
게이트	다음 턴으로 진행하기 전에 승인되어야 하는 인간 또는 정책 기반 체크포인트
할 일	에이전트가 수락하고 실행할 수 있는 범위 제한된 작업 항목
증거	한 턴에서 생성된 파일, 로그, 아티팩트로, 나중에 검토하기 위해 불변으로 저장
할당량	실행 가능한 턴 수에 제한을 두어 과도한 실행을 방지
인수인계	책임을 다른 에이전트 또는 인간에게 구조적으로 이전

작동 방식 – 루프는 다음과 같습니다:

목표 → LoopX 상태 (목표, 게이트, 할 일, 증거, 할당량)
   ├─ 인간 판단 필요 시 → 구체적인 질문 제시, 대기
   ├─ 또는 안전한 백업 존재 시 → 범위 제한된 에이전트 슬라이스 실행
   ▼
에이전트 런타임(Codex, Claude Code 등)이 한 턴 실행
   ▼
LoopX가 증거 기록, 상태 업데이트, 다음 턴 결정

상태는 로컬에 저장되며("로컬 우선" 워크스페이스), 단일 진실의 소스입니다. 에이전트 런타임은 단지 워커일 뿐입니다.

주요 기능

• 개인 워크스페이스 – 브라우저/PWA 또는 네이티브 데스크톱용 로컬 우선 UI로, 재시작 후에도 목표, 활성 작업, 스케줄, 증거를 표시합니다.
• 프로바이더 비의존 어댑터 – Codex App, Claude Code, Cursor, KunlunCode, DeepSeek Harness, 일반 쉘 러너용 플러그인.
• 인간이 개입하는 게이팅 – 상태 변경 전에 명시적인 승인 단계, 타입된 미리보기, 영수증 제공.
• 런타임 간 연속성 – 프로젝트 중에 Codex에서 Claude Code로 전환해도 상태를 잃지 않습니다.
• 감사 대응 증거 그래프 – 각 턴의 출력은 버전 관리되며 작업 그래프로 시각화됩니다.
• 확장 가능한 기술/명령 프레임 – 다양한 IDE 및 채팅 플랫폼에서 /loopx 명령어로 LoopX 노출.
• 벤치마크 및 사례 연구 – SWE-Marathon, LHTB, 자동 ML, 오픈소스 이슈 수정 데모 등 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에서 직접 가져온 것이며, 외부 추측은 포함되지 않았습니다.