BloopAI/vibe-kanban

Get 10X more out of Claude Code, Codex or any coding agent

GitHub에서 열기 ↗ agentai-agentskanbanmanagementtask-manager

27,953

GitHub 스타

2,998

포크

Rust

언어

Apache-2.0

라이선스

2026.04.24

최근 푸시

2026.08.14

별표한 날

AI 분석

설치 난이도: 보통

큐레이터 노트

코딩 에이전트의 계획·실행·검토 워크플로를 칸반으로 관리하려는 개발자에게 유용한 레퍼런스다. 다만 sunsetting 예정이므로 실제 도입보다는 아키텍처와 UX 설계를 참고하는 것이 적합하다.

강점

- 칸반 보드와 코딩 에이전트 실행 환경을 통합해 계획-실행-검토-병합까지 하나의 흐름으로 처리할 수 있다.
- Claude Code, Codex, Gemini CLI 등 10개 이상의 코딩 에이전트를 지원하며, 내장 브라우저와 인라인 댓글 등 검토 경험을 제공한다.
- npx 한 줄로 실행할 수 있고, 셀프 호스팅 및 리버스 프록시 환경을 위한 환경 변수 구성이 문서화되어 있다.

약점

- README에 명시된 대로 프로젝트가 sunsetting(서비스 종료) 단계에 있어 향후 유지보수가 중단될 가능성이 있다.
- 로컬 개발에 Rust, Node.js, pnpm, cargo-watch, sqlx-cli 등 여러 도구가 필요해 초기 설정 비용이 있다.
- 원격 배포 시 SSH 터널 및 VSCode Remote-SSH 등 추가 인프라 구성이 필요하다.

주의사항

- Vibe Kanban이 sunsetting 예정이므로 신규 프로젝트에 도입하기 전에 공지사항과 대안을 확인해야 한다.
- 리버스 프록시나 사용자 지정 도메인 뒤에서 실행할 때 `VK_ALLOWED_ORIGINS`를 설정하지 않으면 403 오류가 발생한다.
- Windows에서 `HOST=0.0.0.0`을 사용할 때 `MCP_HOST`를 `127.0.0.1`로 설정해야 하는 등 플랫폼별 주의사항이 있다.

시작 가이드

- sunsetting 공지사항을 확인해 프로젝트의 향후 지원 계획과 대안을 파악한다.
- 로컬 개발 환경(Rust, Node.js, pnpm, cargo-watch, sqlx-cli)을 준비하고 `pnpm run dev`로 개발 서버를 실행해 본다.
- `VK_ALLOWED_ORIGINS` 등 환경 변수 구성을 숙지하고, 셀프 호스팅 또는 원격 배포 시나리오를 문서로 점검한다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Vibe Kanban

Claude Code, Gemini CLI, Codex, Amp 및 기타 코딩 에이전트에서 10배 더 많은 성과를 얻으세요.

Vibe Kanban은 서비스를 종료합니다. 공지사항을 읽어보세요.

Overview

소프트웨어 엔지니어가 대부분의 시간을 코딩 에이전트를 계획하고 검토하는 데 사용하는 세상에서, 더 많은 결과물을 내기 위한 가장 효과적인 방법은 계획과 검토 속도를 높이는 것입니다.

Vibe Kanban은 바로 이를 위해 만들어졌습니다. 칸반 이슈로 작업을 계획하되, 개인적으로 또는 팀과 함께 계획할 수 있습니다. 작업을 시작할 준비가 되면 코딩 에이전트가 실행될 워크스페이스를 생성하세요.

칸반 이슈로 계획 수립 — 칸반 보드에서 이슈를 생성하고 우선순위를 지정하며 할당할 수 있습니다.
워크스페이스에서 코딩 에이전트 실행 — 각 워크스페이스는 에이전트에게 브랜치, 터미널, 개발 서버를 제공합니다.
diff 검토 및 인라인 댓글 작성 — UI를 벗어나지 않고 에이전트에게 직접 피드백을 보낼 수 있습니다.
앱 미리보기 — devtools, 검사 모드, 기기 에뮬레이션을 갖춘 내장 브라우저를 제공합니다.
10개 이상의 코딩 에이전트 전환 — Claude Code, Codex, Gemini CLI, GitHub Copilot, Amp, Cursor, OpenCode, Droid, CCR, Qwen Code를 지원합니다.
풀 리퀘스트 생성 및 병합 — AI 생성 설명이 포함된 PR을 열고, GitHub에서 검토한 뒤 병합할 수 있습니다.

단 하나의 명령어로. 작업을 설명하고, diff를 검토하고, 결과물을 내보내세요.

npx vibe-kanban

Installation

선호하는 코딩 에이전트로 인증했는지 확인하세요. 지원되는 코딩 에이전트의 전체 목록은 문서에서 확인할 수 있습니다. 그런 다음 터미널에서 다음을 실행하세요:

npx vibe-kanban

Documentation

최신 문서와 사용자 가이드는 웹사이트에서 확인하세요.

Self-Hosting

자체 Vibe Kanban Cloud 인스턴스를 호스팅하고 싶으신가요? 셀프 호스팅 가이드를 참조하세요.

Support

기능 요청은 GitHub Discussions를 사용합니다. 기능 요청을 하려면 discussion을 열어 주세요. 버그는 이 저장소에 issue를 열어 주세요.

Development

사전 요구 사항

Rust (latest stable)
Node.js (>=20)
pnpm (>=8)

추가 개발 도구:

cargo install cargo-watch
cargo install sqlx-cli

의존성 설치:

pnpm i

개발 서버 실행

pnpm run dev

이 명령은 백엔드와 웹 앱을 시작합니다. 빈 DB가 devassetsseed 폴더에서 복사됩니다.

웹 앱 빌드

웹 앱만 빌드하려면:

cd packages/local-web
pnpm run build

소스에서 빌드 (macOS)

./local-build.sh 실행
cd npx-cli && node bin/cli.js로 테스트

환경 변수

다음 환경 변수는 빌드 시점 또는 런타임에 구성할 수 있습니다:

변수	유형	기본값	설명
`POSTHOGAPIKEY`	빌드 시점	비어 있음	PostHog 분석 API 키 (비어 있으면 분석 비활성화)
`POSTHOGAPIENDPOINT`	빌드 시점	비어 있음	PostHog 분석 엔드포인트 (비어 있으면 분석 비활성화)
`PORT`	런타임	자동 할당	프로덕션: 서버 포트. 개발 모드: 프론트엔드 포트 (백엔드는 PORT+1 사용)
`BACKEND_PORT`	런타임	`0` (자동 할당)	백엔드 서버 포트 (개발 모드 전용, PORT+1을 재정의)
`FRONTEND_PORT`	런타임	`3000`	프론트엔드 개발 서버 포트 (개발 모드 전용, PORT를 재정의)
`HOST`	런타임	`127.0.0.1`	백엔드 서버 호스트
`MCP_HOST`	런타임	`HOST` 값	MCP 서버 연결 호스트 (Windows에서 `HOST=0.0.0.0`인 경우 `127.0.0.1` 사용)
`MCP_PORT`	런타임	`BACKEND_PORT` 값	MCP 서버 연결 포트
`DISABLEWORKTREECLEANUP`	런타임	설정 안 됨	고아(orphan) 및 만료된 워크스페이스 정리를 포함한 모든 git worktree 정리를 비활성화 (디버깅용)
`VKALLOWEDORIGINS`	런타임	설정 안 됨	백엔드 API 요청을 허용할 origin 목록(쉼표로 구분) (예: `https://my-vibekanban-frontend.com`)
`VKSHAREDAPI_BASE`	런타임	설정 안 됨	로컬 데스크톱 앱이 사용하는 원격/클라우드 API의 기본 URL
`VKSHAREDRELAYAPIBASE`	런타임	설정 안 됨	터널 모드 연결에 사용되는 릴레이 API의 기본 URL
`VK_TUNNEL`	런타임	설정 안 됨	설정 시 릴레이 터널 모드를 활성화 (릴레이 API 기본 URL 필요)

빌드 시점 변수는 pnpm run build를 실행할 때 설정해야 합니다. 런타임 변수는 애플리케이션 시작 시 읽힙니다.

리버스 프록시 또는 사용자 지정 도메인으로 셀프 호스팅

Vibe Kanban을 리버스 프록시(예: nginx, Caddy, Traefik) 뒤에서 실행하거나 사용자 지정 도메인에서 실행하는 경우 VKALLOWEDORIGINS 환경 변수를 설정해야 합니다. 이 값을 설정하지 않으면 브라우저의 Origin 헤더가 백엔드가 기대하는 호스트와 일치하지 않아 API 요청이 403 Forbidden 오류로 거부됩니다.

프론트엔드에 접근할 수 있는 전체 origin URL로 설정하세요:

# 단일 origin
VK_ALLOWED_ORIGINS=https://vk.example.com

# 여러 origin (쉼표로 구분)
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com

원격 배포

Vibe Kanban을 원격 서버(예: systemctl, Docker, 클라우드 호스팅)에서 실행하는 경우, 에디터가 SSH를 통해 프로젝트를 열도록 구성할 수 있습니다:

터널로 접근: Cloudflare Tunnel, ngrok 등으로 웹 UI를 외부에 노출
Settings → Editor Integration에서 원격 SSH 구성:

Remote SSH Host를 서버 호스트 이름 또는 IP로 설정
Remote SSH User를 SSH 사용자 이름으로 설정 (선택 사항)

사전 요구 사항:

로컬 머신에서 원격 서버로의 SSH 접근
SSH 키 구성 (비밀번호 없는 인증)
VSCode Remote-SSH 확장

구성이 완료되면 'Open in VSCode' 버튼이 vscode://vscode-remote/ssh-remote+user@host/path 형식의 URL을 생성하여 로컬 에디터를 열고 원격 서버에 연결합니다.

자세한 설정 방법은 문서를 참조하세요.

원본 저장소: BloopAI/vibe-kanban

라이선스: Apache-2.0

게재 제외를 원하시면 삭제 요청을 보내주세요.