Vibe Kanban 소개
Vibe Kanban은 개발자가 여러 AI 코딩 에이전트(AI Coding Agents)를 동시에 지휘하고 관리할 수 있게 해주는 오픈소스 AI 오케스트레이션(Orchestration) 플랫폼입니다. BloopAI 팀이 개발한 이 도구는 단순한 작업 관리 보드를 넘어, 로컬 환경에서 실행되는 AI 에이전트들의 작업 공간을 물리적으로 격리하고 병렬 처리를 가능하게 하는 '지휘 본부' 역할을 합니다.
최근 Vibe Coding 열풍이 불며 Claude Code, Gemini CLI, GitHub Copilot Workspace 등 자율적으로 코드를 작성하고 수정하는 에이전트들을 많이 사용하고 있습니다. 그러나 터미널에서 단일 에이전트를 실행하는 기존 방식은 '한 번에 하나의 작업'만 가능하며, 에이전트가 코드를 작성하는 동안 개발자는 대기해야 하는 비효율이 발생합니다. 또한, 에이전트가 생성한 코드가 기존 코드베이스를 훼손하지 않는지 검토하는 과정도 번거롭습니다.
Vibe Kanban은 Git Worktree 기술을 활용하여 이러한 문제를 해결합니다. 개발자는 이 도구를 통해 여러 에이전트에게 동시에 작업을 할당하고(Parallel Execution), 각 에이전트가 안전하게 격리된 환경에서 코드를 작성하게 한 뒤, 변경 사항을 직관적인 UI로 검토(Review)하고 병합(Merge)할 수 있습니다. 이는 안드레 카파시(Andrej Karpathy)가 언급한 'Vibe Coding' (직접 코드를 짜기보다 AI의 결과물을 관리하고 리뷰하는 데 집중하는 방식)을 실현하는 가장 진보된 형태의 도구입니다.
기존 터미널 작업 vs Vibe Kanban 비교
| 특징 | 기존 터미널(CLI) 작업 방식 | Vibe Kanban 오케스트레이션 |
|---|---|---|
| 작업 처리 | 직렬(Serial): 한 번에 하나의 작업만 수행 가능 | 병렬(Parallel): 다수의 에이전트가 동시에 여러 작업 수행 |
| 작업 환경 | 단일 워크스페이스: 메인 브랜치가 'Dirty' 상태가 됨 | 격리된 워크트리: 각 작업마다 별도의 폴더/브랜치 자동 생성 |
| 충돌 위험 | 여러 작업 시 파일 충돌 발생 가능성 높음 | Git Worktree로 물리적 격리되어 충돌 없음 |
| 코드 리뷰 | 별도의 Git GUI나 에디터를 열어 확인해야 함 | 내장된 Diff 뷰어로 즉시 확인 및 수정 가능 |
| 확장성 | 터미널 창을 여러 개 띄워야 해서 관리가 힘듦 | 칸반 보드 UI에서 수십 개의 작업을 한눈에 관리 |
Vibe Kanban의 주요 기능: 코딩 에이전트 실행 및 작업 관리
Git Worktree 기반의 강력한 격리 (Isolation)
Vibe Kanban의 핵심 기술은 Git Worktree입니다. 사용자가 작업을 생성하면, Vibe Kanban은 메인 프로젝트 폴더를 건드리지 않고, 별도의 격리된 디렉토리(Worktree)를 생성하여 에이전트에게 할당합니다.
- 이점: 메인 브랜치는 항상 깨끗한 상태를 유지합니다. 에이전트 A가
feature-login을 개발하는 동안, 에이전트 B가fix-bug를 처리해도 서로의 파일 시스템을 침범하지 않습니다. - 작동 방식: 작업이 완료되면 격리된 워크트리에서 생성된 변경 사항을 메인 워크트리로 가져와 병합(Merge)하거나 리베이스(Rebase)합니다.
멀티 에이전트 지원 (Agent Agnostic)
특정 AI 모델에 락인(Lock-in)되지 않고, 다양한 CLI 기반 코딩 에이전트를 지원합니다. 사용자는 작업의 성격에 따라 가장 적합한 에이전트를 선택하여 투입할 수 있습니다.
현재 Vibe Kanban이 지원하는 코딩 에이전트들은 다음과 같습니다:
- Claude Code (Anthropic)
- Gemini CLI (Google)
- OpenAI Codex
- Amp (BloopAI 자체 에이전트)
- Cursor Agent CLI
특히, Vibe Kanban은 claude나 gh (GitHub CLI) 등 터미널 명령어로 실행 가능한 대부분의 도구와 연동될 수 있도록 설계된 점이 특징입니다.
직관적인 코드 리뷰 및 병합 (Visual Code Review)
Vibe Kanban은 코드 에이전트가 작업을 마치면 리뷰(Review) 단계로 넘어갑니다. 이 리뷰 단계에서는 GitHub의 PR 리뷰 화면처럼, 변경된 코드의 차이점을 줄 단위로 시각적으로 보여줍니다.
개발자는 에이전트가 작성/변경한 코드를 눈으로 확인하고, 마음에 들지 않으면 에이전트에게 추가 지시를 내리거나 직접 수정할 수 있습니다. (HITL, Human-in-the-Loop) 이후, 개발자의 검토가 끝난 코드는 클릭 한 번으로 메인 브랜치에 병합됩니다.
원격 개발 및 SSH 지원 (Remote Development)
로컬 머신뿐만 아니라 원격 서버에서도 Vibe Kanban을 실행할 수 있습니다.
-
SSH 통합: 원격 서버(예: AWS EC2, 사내 서버)에 Vibe Kanban을 띄워두고, 로컬 브라우저로 접속하여 제어할 수 있습니다.
-
에디터 연동: VS Code Remote-SSH 등과 연동하여, 원격지에서 생성된 워크트리를 로컬 에디터에서 바로 열어볼 수 있는 기능을 제공합니다.
Vibe Kanban의 심화 기능: 복잡한 개발 워크플로우 처리
Vibe Kanban은 단순히 AI 에이전트를 실행하는 것을 넘어, 복잡한 개발 워크플로우를 처리하기 위한 정교한 작업 관리(Task Management) 및 통합(Integration) 기능을 제공합니다.
서브태스크 분할 및 병렬 처리 (Subtasks)
복잡하고 큰 작업을 하나의 에이전트에게 맡기면 컨텍스트가 길어지거나 오류가 발생할 확률이 높습니다. Vibe Kanban은 이를 해결하기 위해 서브태스크(Subtasks) 기능을 제공합니다.
- 자동 및 수동 분할: 사용자가 직접 작업을 쪼개거나, 'Plan' 단계에서 AI가 작업을 분석하여 여러 개의 하위 작업으로 자동 분할할 수 있습니다.
- 독립적 실행 환경: 각 서브태스크는 메인 작업과 별개로 개별적인 Git Worktree를 할당받습니다. 즉, 프론트엔드 수정(Subtask A)과 백엔드 API 수정(Subtask B)을 완전히 격리된 상태에서 동시에 진행할 수 있습니다.
- 병합 흐름: 모든 서브태스크가 완료되면, 상위 작업(Parent Task)으로 결과물이 병합되고, 최종적으로 메인 브랜치에 반영됩니다.
새로운 시도 및 복구 (New Task Attempts)
AI 에이전트가 엉뚱한 코드를 작성하거나, 루프에 빠져 복구 불가능한 상태가 되는 경우가 빈번합니다. 기존에는 터미널을 초기화하거나 코드를 일일이 지워야 했지만, Vibe Kanban은 'New Attempt' 기능을 통해 이를 우아하게 해결합니다.
- 깨끗한 상태에서 재시작: 'New Attempt'를 실행하면, 현재 망가진 작업 상태를 버리고 작업이 시작되기 직전의 깨끗한 상태(Base State) 에서 새로운 워크트리를 생성합니다.
- 프롬프트 보존: 기존에 입력했던 프롬프트와 지시사항은 그대로 유지되므로, 사용자는 추가적인 수정 지시만 내리면 됩니다.
- 비파괴적 방식: 이전의 실패한 시도(Attempt)도 기록에 남기 때문에, 필요하다면 이전 시도에서 작성된 코드의 일부를 참조할 수도 있습니다.
리베이스 충돌 해결 (Resolving Rebase Conflicts)
개발자가 로컬에서 작업을 진행하는 동안 메인 브랜치(main/master)가 업데이트되는 경우(예: 팀원이 코드를 푸시함), 병합 시 충돌이 발생할 수 있습니다.
- 자동 리베이스 감지: Vibe Kanban은 에이전트의 작업물을 메인 브랜치에 병합하기 전에 자동으로 리베이스(Rebase) 를 시도합니다.
- 충돌 해결 UI: 리베이스 중 충돌(Conflict)이 발생하면 작업이 일시 중지되고, UI에서 충돌 해결 모드로 진입합니다. 사용자는 VS Code와 같은 외부 에디터를 열어 충돌을 해결한 뒤, Vibe Kanban에서 'Continue'를 눌러 병합 과정을 마무리할 수 있습니다.
- 데이터 보호: 충돌 해결 과정이 완료될 때까지 코드는 안전하게 격리되어 있어 메인 프로젝트를 오염시키지 않습니다.
VS Code 확장 프로그램 통합 (VS Code Extension)
Vibe Kanban은 웹 UI뿐만 아니라 개발자에게 가장 익숙한 에디터인 VS Code와의 긴밀한 통합을 지원합니다.
- 워크트리 즉시 열기: 웹 UI에서 특정 작업의 'Open in VS Code' 버튼을 누르면, 해당 작업이 진행 중인 격리된 워크트리 폴더가 VS Code의 새 창에서 바로 열립니다.
- 원활한 핸드오프(Handoff): AI가 작성한 코드를 눈으로만 확인하는 것이 아니라, VS Code의 강력한 기능(Linter, Debugger 등)을 사용하여 직접 수정하고 테스트한 뒤 다시 Vibe Kanban으로 돌아와 작업을 완료할 수 있습니다.
MCP 서버 구성 (MCP Server Configuration)
MCP(Model Context Protocol) 는 AI 모델이 외부 데이터나 도구와 표준화된 방식으로 소통할 수 있게 해주는 프로토콜입니다. Vibe Kanban은 이 MCP를 완벽하게 지원하여 에이전트의 능력을 확장합니다.
- 도구(Tools) 확장: 로컬 데이터베이스 조회, 특정 API 호출, 파일 시스템 검색 등 기본 모델이 할 수 없는 작업을 MCP 서버를 통해 수행할 수 있게 됩니다.
- 설정 파일 관리: 프로젝트 루트의 설정 파일(예:
vibekanban.json또는 MCP 전용 설정)을 통해 사용할 MCP 서버를 정의하고, 에이전트가 작업 수행 시 이 서버들을 도구로 활용하도록 연결할 수 있습니다. - 보안 및 제어: 어떤 도구를 사용할지 명시적으로 설정하므로, 에이전트가 무분별하게 외부 시스템에 접근하는 것을 제어할 수 있습니다.
Vibe Kanban 설치 및 시작하기
Vibe Kanban을 설치 및 사용하기 위해서는 다음과 같은 환경이 필요합니다:
- Node.js: v18 이상
- Git: 최신 버전 권장
- AI 에이전트 인증: 사용하려는 에이전트(예: Claude Code)가 시스템에 설치되어 있고 인증(Login)이 완료되어 있어야 합니다.
위와 같은 환경이 구성되어 있다면, 별도의 설치 과정 없이 npx를 통해 즉시 Vibe Kanban을 실행할 수 있습니다. 프로젝트 루트 디렉토리에서 아래 명령어를 입력하세요.
npx vibe-kanban
명령어를 실행하면 로컬 서버(보통 http://localhost:3000)가 시작되고 브라우저가 자동으로 열립니다.
포트를 변경하고 싶다면, PORT 환경 변수를 사용할 수 있습니다. 예를 들어 54321 포트로 실행하려면 다음과 같이 실행하면 됩니다:
PORT=54321 npx vibe-kanban
Vibe Kanban이 지원하는 더 많은 환경 변수들(HOST, POSTHOG_API_KEY, POSTHOG_API_ENDPOINT 등)에 대해서는 GItHub 저장소의 README를 참고해주세요.
라이선스
Vibe Kanban 프로젝트는 Apache-2.0 라이선스로 배포되고 있습니다. 누구나 자유롭게 사용, 수정 및 재배포가 가능합니다.
Vibe Kanban 공식 홈페이지
Vibe Kanban 공식 문서
Vibe Kanban 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 