asklokesh/loki-mode

Loki Mode – 자율적이고 사양 기반의 코딩 어시스턴트

무엇인가요 – Loki Mode는 제품 사양(1줄의 아이디어, PRD 파일, OpenAPI 사양 등)을 제공하면 요청된 소프트웨어의 완전한 자동 빌드를 수행하는 CLI/SDK 도구입니다. 이 도구는 검증 완료 워크플로우를 기반으로 하며, 생성된 코드가 사양을 충족하고, 테스트를 통과하며, 빌드되며(옵션으로 런타임 헬스 체크도 수행) 결정론적 검사로 이를 입증할 때까지 에이전트가 실행됩니다. 증거는 나중에 감사할 수 있는 서명된 "증거 수령서"로 저장됩니다.

작동 방식 –

• 사양을 제공합니다. Loki는 복잡도를 분류하고 시작 템플릿을 선택합니다.
• 오케스트레이터는 8개 영역에 걸쳐 41개의 전문 에이전트 역할 팀을 구성하여 RARV 루프(Reason → Act → Reflect → Verify)를 수행하며, 8개의 내장된 품질 게이트 체크(테스트, 빌드, 정적 분석, 시크릿 스캔, 런타임 헬스 등)를 수행합니다.
• 에이전트는 Anthropic의 Claude 모델(또는 호환 가능한 LLM)에서 실행되며, 실행 중에 모델을 전환할 수 있습니다.
• 모든 게이트가 통과하면 Loki는 생성된 리포지토리와 기계 검증 가능한 수령서(.loki/proofs//)를 작성합니다. 이 수령서에는 차이점 해시, 테스트/빌드 결과, GPG 서명된 증명이 포함됩니다.

주요 명령어

명령어	목적
loki quickstart "<idea>" --yes	짧은 아이디어에서 단일 명령으로 빌드. 템플릿 선택, 비용/시간 추정 표시 후 추가 프롬프트 없이 빌드.
loki start <spec.md>	작성한 완전한 사양 파일에서 빌드.
loki modernize heal <repo> --assess	기존 코드베이스에 대한 읽기 전용 분석. 성숙도 평가, 부채 신호, 저위험 개선 대상의 순위 목록 제공.
loki proof verify <id>	수령서를 재해싱하고 차이점이 일치하는지 확인. 정상 검증 시 exit 0 반환.
loki doctor	필요한 환경 변수(예: ANTHROPIC_API_KEY) 및 종속성 존재 여부 확인.
loki quickstart --dry-run --json > preview.json	파일 작성이나 모델 호출 없이 결정론적 계획 미리보기(템플릿 선택, 비용 추정, 사양 해시) 생성.
loki verify	어떤 브랜치/PR 차이에 대해 Loki의 품질 게이트 체크를 실행. CI 친화적 종료 코드(0 = 검증됨, 1 = 우려, 2 = 차단됨) 반환.

설치 – 프로젝트는 여러 채널을 통해 Node 기반 CLI를 배포합니다. 추천 방법은 bun install -g loki-mode (빠른 시작). npm, Homebrew, Docker 이미지도 제공됩니다. Claude IDE 통합에 /loki-grill, /loki-spec-status, /loki-verify라는 Claude Code 플러그인을 추가할 수 있습니다.

"검증 완료"가 중요한 이유 – 많은 로컬 코딩 에이전트는 실제로 변경이 없거나 테스트가 실패한 상태에서 "완료"라고 주장합니다. Loki는 다음 조건이 모두 충족되지 않으면 실행을 완료로 간주하지 않습니다:

1. git diff가 비어 있지 않음.
2. 모든 필수 테스트가 통과(실제 N passed 출력).
3. 빌드 성공.
4. 선택적 게이트(런타임 헬스, 시크릿 유출 탐지) 통과. 어느 게이트가 불확실하면 수령서에 간극(예: VERIFIED WITH GAPS)이 기록됩니다. 수령서는 정확한 차이점 해시에 연결된 일반 파일이므로, 에이전트의 자가 보고를 신뢰하지 않고도 누구나 재검증할 수 있습니다.

증거 수령서 – 각 실행은 .loki/proofs/ 아래에 디렉터리를 생성하며, 다음을 포함합니다:

• 생성된 변경의 diff_sha256.
• 테스트, 빌드, 게이트 결과.
• AI 생성 "의회 판결"(평가로 표시, 증명이 아님).
• 선택적으로 분리된 GPG 서명(LOKI_PROOF_GPG_KEY). 제목(VERIFIED, VERIFIED WITH GAPS, 또는 NOT VERIFIED)은 결정론적 사실 에서만 유도됩니다.

사용 사례

• 빠른 프로토타이핑 – 단일 명령어로 짧은 아이디어를 실행 가능한 풀스택 앱(포함 Docker-compose)으로 전환.
• 레거시 현대화 – 기존 리포지토리에 대해 읽기 전용 평가를 실행하고, 우선순위가 매겨진 저위험 변경 목록을 얻은 후, 엄격한 검증 하에 Loki가 적용.
• CI 통합 – loki verify를 파이프라인에서 사용해 PR이 자율 에이전트가 사용하는 동일한 품질 게이트를 충족하도록 강제.
• 감사 가능한 AI 생성 코드 – 수령서를 풀 리퀘스트에 첨부. 리뷰어는 차이점과 테스트 결과를 독립적으로 검증 가능.

제한 사항 / 주의사항

• 실행에는 Anthropic API 키(또는 호환 모델)가 필요. 모델 없이는 미리보기만 가능.
• "검증됨" 주장의 강도는 결정론적 검사에 달려 있음. 악의적인 공격자가 사실과 수령서를 모두 재작성해 일관성을 유지할 수 있으므로, 고신뢰 시나리오에서는 서명된 수령서를 권장.
• 현재 CLI는 기본적으로 Claude 기반 제공자만 지원. 다른 모델은 맞춤 통합 필요.
• 도구는 오픈소스지만 상용 에디션(Autonomi Cloud/Enterprise)은 팀 수준 기능 추가. 무료 버전은 일부 엔터프라이즈 수준 오케스트레이션 또는 UI 구성 요소가 누락될 수 있음.

결론 – Loki Mode는 진정한 오픈소스 자율 코딩 에이전트로, 검증을 통한 신뢰 를 강조합니다. 사양에서 코드까지의 전 과정을 자동화하고, 무엇을 했는지 결정론적 증거를 제공하며, 스크립트나 CI 환경에서 안전하게 사용할 수 있는 명령어 세트를 제공합니다.