kagan-sh/kagan
요약
Kagan은 AI 코딩 에이전트의 작업 결과물을 안전하게 관리하기 위한 Kanban 스타일의 TUI(Terminal User Interface) 도구입니다. 상태 머신을 통해 인간의 명시적인 검토와 승인 없이는 메인 브랜치에 코드가 병합되지 않도록 강제하는 구조적인 검토 게이트를 제공합니다.
핵심 포인트
- 상태 머신을 활용하여 인간의 승인 없이는 메인 브랜치 병합을 원천 차단하는 구조적 안전장치 제공
- 에이전트 작업을 격리된 git worktree 환경에서 실행하여 안정성 확보
- 사용자가 diff 확인 및 수락 기준 검토 후 승인하는 명확한 리뷰 워크플로우 지원
- uv 및 쉘 스크립트를 통한 간편한 설치 지원
Kagan은 구조적인 인간 검토 게이트(human review gate)를 갖춘 AI 코딩 에이전트용 Kanban TUI입니다. 에이전트가 작성한 작업은 명시적인 승인 없이는 메인 브랜치(main branch)에 도달할 수 없으며, 상태 머신(state machine)이 이를 강제합니다.
에이전트는 격리된 git 워크트리(worktree)에서 실행됩니다. 작업이 완료되면 작업 카드(task card)는 REVIEW 상태로 이동합니다. 사용자는 diff를 읽고, 수락 기준(acceptance criteria)을 확인한 뒤 승인(approve)을 누릅니다. 그러면 머지(merge)가 실행됩니다. REVIEW에서 DONE으로의 전환은 자동화로 건너뛸 수 없습니다. 이는 설정의 문제가 아닙니다.
uv tool install kagan # 또는: uvx kagan
Mac / Linux (uv 미사용 시)
curl -fsSL https://uvget.me/install.sh | bash -s -- kagan
Windows (PowerShell)
`iwr -useb uvget.me/install.ps1 -OutFile install.ps1; .\
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기