Vibe Kanban

#!/usr/bin/env bash
# cleanup.sh — Vibe Kanban worktree 정리 스크립트
# 사용법: bash cleanup.sh [--all] [--dry-run]
#
# 예시:
#   bash cleanup.sh              # 병합된 worktree만 정리
#   bash cleanup.sh --all        # 모든 vibe-kanban worktree 정리
#   bash cleanup.sh --dry-run    # 정리할 항목만 표시 (실제 삭제 안함)

set -euo pipefail

RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
info()  { echo -e "${BLUE}ℹ️  $*${NC}"; }
ok()    { echo -e "${GREEN}✅ $*${NC}"; }
warn()  { echo -e "${YELLOW}⚠️  $*${NC}"; }
error() { echo -e "${RED}❌ $*${NC}" >&2; }

# ─── 인자 파싱 ───────────────────────────────────────────────────────────────
CLEAN_ALL=false
DRY_RUN=false

while [[ $# -gt 0 ]]; do
  case "$1" in
    --all)     CLEAN_ALL=true; shift ;;
    --dry-run) DRY_RUN=true; shift ;;
    *) shift ;;
  esac
done

echo "╔══════════════════════════════════════╗"
echo "║  Vibe Kanban Worktree 정리           ║"
echo "╚══════════════════════════════════════╝"
echo ""

# ─── Git 저장소 확인 ─────────────────────────────────────────────────────────
if ! git rev-parse --git-dir &>/dev/null; then
  error "Git 저장소가 아닙니다."
  exit 1
fi

# ─── Worktree 목록 조회 ──────────────────────────────────────────────────────
info "현재 worktree 목록:"
git worktree list
echo ""

# ─── 정리 대상 식별 ──────────────────────────────────────────────────────────
WORKTREES=$(git worktree list --porcelain | grep "^worktree" | cut -d' ' -f2-)
VK_WORKTREES=()

while IFS= read -r wt; do
  if [[ "$wt" == *"vk-"* ]] || [[ "$wt" == *"vibe-kanban-"* ]]; then
    VK_WORKTREES+=("$wt")
  fi
done <<< "$WORKTREES"

if [[ ${#VK_WORKTREES[@]} -eq 0 ]]; then
  ok "정리할 Vibe Kanban worktree가 없습니다."
  exit 0
fi

info "Vibe Kanban worktree 발견: ${#VK_WORKTREES[@]}개"
for wt in "${VK_WORKTREES[@]}"; do
  echo "  - $wt"
done
echo ""

# ─── 정리 실행 ───────────────────────────────────────────────────────────────
CLEANED=0

for wt in "${VK_WORKTREES[@]}"; do
  # 브랜치명 추출
  BRANCH=$(git worktree list | grep "$wt" | awk '{print $3}' | tr -d '[]')
  
  # 병합 여부 확인 (--all이 아닌 경우)
  if [[ "$CLEAN_ALL" == "false" ]]; then
    if ! git branch --merged main 2>/dev/null | grep -q "$BRANCH"; then
      warn "스킵: $wt (병합되지 않음)"
      continue
    fi
  fi
  
  if [[ "$DRY_RUN" == "true" ]]; then
    info "[DRY-RUN] 삭제 예정: $wt"
  else
    info "정리 중: $wt"
    git worktree remove "$wt" --force 2>/dev/null || true
    git branch -D "$BRANCH" 2>/dev/null || true
    ((CLEANED++))
  fi
done

echo ""

# ─── Worktree prune ──────────────────────────────────────────────────────────
if [[ "$DRY_RUN" == "false" ]]; then
  info "git worktree prune 실행..."
  git worktree prune
fi

# ─── 결과 출력 ───────────────────────────────────────────────────────────────
if [[ "$DRY_RUN" == "true" ]]; then
  info "DRY-RUN 모드: 실제 삭제 없음"
else
  ok "정리 완료: ${CLEANED}개 worktree 삭제됨"
fi

echo ""
info "현재 worktree 목록:"
git worktree list

#!/usr/bin/env bash
# health-check.sh — Vibe Kanban 서버 상태 확인 스크립트
# 사용법: bash health-check.sh [--port 3000] [--json]
#
# 예시:
#   bash health-check.sh
#   bash health-check.sh --port 3001
#   bash health-check.sh --json

set -euo pipefail

RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
info()  { echo -e "${BLUE}ℹ️  $*${NC}"; }
ok()    { echo -e "${GREEN}✅ $*${NC}"; }
warn()  { echo -e "${YELLOW}⚠️  $*${NC}"; }
error() { echo -e "${RED}❌ $*${NC}" >&2; }

# ─── 인자 파싱 ───────────────────────────────────────────────────────────────
PORT="${VIBE_KANBAN_PORT:-3000}"
JSON_OUTPUT=false

while [[ $# -gt 0 ]]; do
  case "$1" in
    --port) PORT="$2"; shift 2 ;;
    --json) JSON_OUTPUT=true; shift ;;
    *) shift ;;
  esac
done

BASE_URL="http://localhost:$PORT"

# ─── JSON 출력 모드 ──────────────────────────────────────────────────────────
if [[ "$JSON_OUTPUT" == "true" ]]; then
  RESULT='{}'
  
  # 서버 상태
  if curl -s "$BASE_URL/api/health" &>/dev/null; then
    RESULT=$(echo "$RESULT" | jq '. + {"server": "running", "port": '"$PORT"'}')
  else
    RESULT=$(echo "$RESULT" | jq '. + {"server": "stopped", "port": '"$PORT"'}')
    echo "$RESULT"
    exit 1
  fi
  
  # 카드 수
  CARDS=$(curl -s "$BASE_URL/api/cards" 2>/dev/null | jq 'length' 2>/dev/null || echo "0")
  RESULT=$(echo "$RESULT" | jq '. + {"cards": '"$CARDS"'}')
  
  # Worktree 수
  if git rev-parse --git-dir &>/dev/null; then
    WT_COUNT=$(git worktree list | wc -l | tr -d ' ')
    RESULT=$(echo "$RESULT" | jq '. + {"worktrees": '"$WT_COUNT"'}')
  fi
  
  echo "$RESULT"
  exit 0
fi

# ─── 일반 출력 모드 ──────────────────────────────────────────────────────────
echo "╔══════════════════════════════════════╗"
echo "║  Vibe Kanban 상태 확인               ║"
echo "╚══════════════════════════════════════╝"
echo ""

# 서버 상태
info "서버 상태 확인: $BASE_URL"
if curl -s --connect-timeout 2 "$BASE_URL/api/health" &>/dev/null; then
  ok "서버: 실행 중 (포트 $PORT)"
else
  error "서버: 응답 없음"
  echo ""
  echo "서버를 시작하려면:"
  echo "  npx vibe-kanban"
  echo "  또는"
  echo "  bash scripts/start.sh"
  exit 1
fi

# 카드 상태
echo ""
info "카드 상태:"
CARDS_JSON=$(curl -s "$BASE_URL/api/cards" 2>/dev/null || echo "[]")

if command -v jq &>/dev/null; then
  TODO=$(echo "$CARDS_JSON" | jq '[.[] | select(.column == "todo")] | length')
  IN_PROGRESS=$(echo "$CARDS_JSON" | jq '[.[] | select(.column == "in_progress")] | length')
  REVIEW=$(echo "$CARDS_JSON" | jq '[.[] | select(.column == "review")] | length')
  DONE=$(echo "$CARDS_JSON" | jq '[.[] | select(.column == "done")] | length')
  
  echo "  To Do:       $TODO"
  echo "  In Progress: $IN_PROGRESS"
  echo "  Review:      $REVIEW"
  echo "  Done:        $DONE"
else
  TOTAL=$(echo "$CARDS_JSON" | grep -o '"id"' | wc -l | tr -d ' ')
  echo "  총 카드 수: $TOTAL"
fi

# Git worktree 상태
echo ""
info "Git Worktree 상태:"
if git rev-parse --git-dir &>/dev/null; then
  git worktree list | while read -r line; do
    if [[ "$line" == *"vk-"* ]] || [[ "$line" == *"vibe-kanban-"* ]]; then
      echo "  [VK] $line"
    fi
  done
  
  VK_COUNT=$(git worktree list | grep -E "(vk-|vibe-kanban-)" | wc -l | tr -d ' ')
  if [[ "$VK_COUNT" -eq 0 ]]; then
    echo "  Vibe Kanban worktree 없음"
  else
    echo "  총 VK worktree: $VK_COUNT"
  fi
else
  warn "Git 저장소가 아닙니다."
fi

# MCP 상태
echo ""
info "MCP 상태:"
MCP_PORT="${MCP_PORT:-3001}"
if curl -s --connect-timeout 2 "http://localhost:$MCP_PORT" &>/dev/null; then
  ok "MCP 서버: 실행 중 (포트 $MCP_PORT)"
else
  echo "  MCP 서버: 실행 안함"
  echo "  시작하려면: npx vibe-kanban --mcp"
fi

echo ""
ok "상태 확인 완료"

#!/usr/bin/env bash
# mcp-setup.sh — Vibe Kanban MCP 서버 설정 스크립트
# 사용법: bash mcp-setup.sh [--claude|--codex|--all]
#
# 예시:
#   bash mcp-setup.sh --claude   # Claude Code 설정만
#   bash mcp-setup.sh --codex    # Codex CLI 설정만
#   bash mcp-setup.sh --all      # 모든 에이전트 설정

set -euo pipefail

RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
info()  { echo -e "${BLUE}ℹ️  $*${NC}"; }
ok()    { echo -e "${GREEN}✅ $*${NC}"; }
warn()  { echo -e "${YELLOW}⚠️  $*${NC}"; }
error() { echo -e "${RED}❌ $*${NC}" >&2; }

# ─── 인자 파싱 ───────────────────────────────────────────────────────────────
SETUP_CLAUDE=false
SETUP_CODEX=false

while [[ $# -gt 0 ]]; do
  case "$1" in
    --claude) SETUP_CLAUDE=true; shift ;;
    --codex)  SETUP_CODEX=true; shift ;;
    --all)    SETUP_CLAUDE=true; SETUP_CODEX=true; shift ;;
    *) shift ;;
  esac
done

# 기본값: 모두 설정
if [[ "$SETUP_CLAUDE" == "false" && "$SETUP_CODEX" == "false" ]]; then
  SETUP_CLAUDE=true
  SETUP_CODEX=true
fi

echo "╔══════════════════════════════════════╗"
echo "║  Vibe Kanban MCP 설정                ║"
echo "╚══════════════════════════════════════╝"
echo ""

# ─── MCP 설정 JSON 생성 ──────────────────────────────────────────────────────
MCP_CONFIG=$(cat <<'EOF'
{
  "vibe-kanban": {
    "command": "npx",
    "args": ["vibe-kanban", "--mcp"],
    "env": {
      "MCP_HOST": "127.0.0.1",
      "MCP_PORT": "3001"
    }
  }
}
EOF
)

# ─── Claude Code 설정 ────────────────────────────────────────────────────────
if [[ "$SETUP_CLAUDE" == "true" ]]; then
  info "Claude Code MCP 설정 중..."
  
  CLAUDE_CONFIG="$HOME/.claude/claude_desktop_config.json"
  CLAUDE_DIR="$HOME/.claude"
  
  # 디렉토리 생성
  mkdir -p "$CLAUDE_DIR"
  
  if [[ -f "$CLAUDE_CONFIG" ]]; then
    # 기존 설정에 병합
    if command -v jq &>/dev/null; then
      EXISTING=$(cat "$CLAUDE_CONFIG")
      MERGED=$(echo "$EXISTING" | jq --argjson vk "$MCP_CONFIG" '.mcpServers += $vk')
      echo "$MERGED" > "$CLAUDE_CONFIG"
      ok "Claude Code: 기존 설정에 병합됨"
    else
      warn "jq가 없어 수동 병합이 필요합니다."
      echo "다음 내용을 $CLAUDE_CONFIG의 mcpServers에 추가하세요:"
      echo "$MCP_CONFIG"
    fi
  else
    # 새 설정 파일 생성
    cat > "$CLAUDE_CONFIG" <<EOF
{
  "mcpServers": $MCP_CONFIG
}
EOF
    ok "Claude Code: 새 설정 파일 생성됨"
  fi
  
  echo "  설정 파일: $CLAUDE_CONFIG"
  echo ""
fi

# ─── Codex CLI 설정 ──────────────────────────────────────────────────────────
if [[ "$SETUP_CODEX" == "true" ]]; then
  info "Codex CLI MCP 설정 중..."
  
  CODEX_CONFIG="$HOME/.codex/config.toml"
  CODEX_DIR="$HOME/.codex"
  
  # 디렉토리 생성
  mkdir -p "$CODEX_DIR"
  
  # TOML 형식으로 변환
  CODEX_MCP_CONFIG=$(cat <<'EOF'

# Vibe Kanban MCP Server
[[mcp_servers]]
name = "vibe-kanban"
command = "npx"
args = ["vibe-kanban", "--mcp"]

[mcp_servers.env]
MCP_HOST = "127.0.0.1"
MCP_PORT = "3001"
EOF
)

  if [[ -f "$CODEX_CONFIG" ]]; then
    # 기존 설정에 추가
    if ! grep -q "vibe-kanban" "$CODEX_CONFIG"; then
      echo "$CODEX_MCP_CONFIG" >> "$CODEX_CONFIG"
      ok "Codex CLI: 기존 설정에 추가됨"
    else
      warn "Codex CLI: 이미 vibe-kanban 설정이 존재합니다."
    fi
  else
    # 새 설정 파일 생성
    cat > "$CODEX_CONFIG" <<EOF
# Codex CLI Configuration
$CODEX_MCP_CONFIG
EOF
    ok "Codex CLI: 새 설정 파일 생성됨"
  fi
  
  echo "  설정 파일: $CODEX_CONFIG"
  echo ""
fi

# ─── 완료 ────────────────────────────────────────────────────────────────────
ok "MCP 설정 완료!"
echo ""
echo "다음 단계:"
echo "  1. 에이전트를 재시작하세요"
echo "  2. 'npx vibe-kanban --mcp'로 MCP 서버 시작"
echo "  3. 에이전트에서 vibe-kanban MCP 도구 사용 가능"
echo ""
echo "MCP 도구 목록:"
echo "  - vk_list_cards: 카드 목록 조회"
echo "  - vk_create_card: 새 카드 생성"
echo "  - vk_move_card: 카드 이동"
echo "  - vk_get_logs: 에이전트 로그 조회"

#!/usr/bin/env bash
# vibe-kanban-start.sh — Vibe Kanban 서버 시작 래퍼
# 사용법: bash scripts/vibe-kanban-start.sh [--port 3000] [--remote]
#
# 예시:
#   bash scripts/vibe-kanban-start.sh
#   bash scripts/vibe-kanban-start.sh --port 3001
#   bash scripts/vibe-kanban-start.sh --remote

set -euo pipefail

RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
info()  { echo -e "${BLUE}ℹ️  $*${NC}"; }
ok()    { echo -e "${GREEN}✅ $*${NC}"; }
warn()  { echo -e "${YELLOW}⚠️  $*${NC}"; }
error() { echo -e "${RED}❌ $*${NC}" >&2; }

# ─── 인자 파싱 ───────────────────────────────────────────────────────────────
PORT="${VIBE_KANBAN_PORT:-3000}"
REMOTE="${VIBE_KANBAN_REMOTE:-false}"
OPEN_BROWSER=true

while [[ $# -gt 0 ]]; do
  case "$1" in
    --port)   PORT="$2"; shift 2 ;;
    --remote) REMOTE=true; shift ;;
    --no-open) OPEN_BROWSER=false; shift ;;
    *) shift ;;
  esac
done

echo "╔══════════════════════════════════════╗"
echo "║  Vibe Kanban 시작                     ║"
echo "╚══════════════════════════════════════╝"
echo ""

# ─── Node.js 확인 ────────────────────────────────────────────────────────────
if ! command -v node &>/dev/null; then
  error "Node.js가 필요합니다. https://nodejs.org 에서 설치하세요."
  exit 1
fi

NODE_MAJOR=$(node --version | sed 's/v//' | cut -d. -f1)
if [[ $NODE_MAJOR -lt 18 ]]; then
  error "Node.js 18+ 필요 (현재: $(node --version))"
  exit 1
fi
ok "Node.js: $(node --version)"

# ─── npx 확인 ────────────────────────────────────────────────────────────────
if ! command -v npx &>/dev/null; then
  error "npx가 필요합니다 (Node.js와 함께 설치됩니다)"
  exit 1
fi

# ─── 에이전트 인증 확인 ──────────────────────────────────────────────────────
echo ""
info "에이전트 인증 상태 확인..."

if [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
  ok "ANTHROPIC_API_KEY: 설정됨 (Claude 사용 가능)"
else
  warn "ANTHROPIC_API_KEY: 미설정 (Claude 에이전트 사용 불가)"
fi

if [[ -n "${OPENAI_API_KEY:-}" ]]; then
  ok "OPENAI_API_KEY: 설정됨 (Codex/GPT 사용 가능)"
else
  warn "OPENAI_API_KEY: 미설정 (Codex 에이전트 사용 불가)"
fi

echo ""

# ─── 환경 변수 설정 ──────────────────────────────────────────────────────────
export VIBE_KANBAN_PORT="$PORT"
export VIBE_KANBAN_REMOTE="$REMOTE"

# .env 파일 로드 (존재하는 경우)
if [[ -f ".env" ]]; then
  info ".env 파일 로드 중..."
  set -a
  source .env
  set +a
fi

# ─── 실행 정보 ───────────────────────────────────────────────────────────────
echo "설정:"
echo "  포트   : $PORT"
echo "  원격   : $REMOTE"
echo "  URL    : http://localhost:$PORT"
if [[ "$REMOTE" == "true" ]]; then
  warn "원격 연결 허용됨. 신뢰할 수 있는 네트워크에서만 사용하세요."
fi
echo ""

# ─── 브라우저 자동 오픈 (백그라운드) ────────────────────────────────────────
if [[ "$OPEN_BROWSER" == "true" ]]; then
  (
    sleep 3
    if command -v open &>/dev/null; then
      open "http://localhost:$PORT" 2>/dev/null || true
    elif command -v xdg-open &>/dev/null; then
      xdg-open "http://localhost:$PORT" 2>/dev/null || true
    fi
  ) &
fi

# ─── vibe-kanban 실행 ────────────────────────────────────────────────────────
info "Vibe Kanban 시작 중 (npx vibe-kanban)..."
echo "종료하려면 Ctrl+C"
echo ""

exec npx vibe-kanban

N:vibe-kanban
V:1.2.0
D:Visual Kanban board for AI agents. To Do->In Progress->Review->Done flow. Automatic git worktree isolation, MCP integration, and GitHub PR auto-generation. Supports remote deployment.
G:vibe-kanban kanban multi-agent git-worktree github-pr mcp task-management claude-code codex gemini docker remote
U[6]:
  Break epics into independent tasks and assign agents in parallel
  Visually track AI agent task status (To Do->Done)
  In the Review column, inspect diffs/logs via browser UI and retry if needed
  Combine GitHub PR-based team collaboration with AI agent execution
  Compare two agents on the same task (implementation comparison strategy)
  MCP integration allows agents to call board APIs directly
S[5]{n,action,details}:
  1,Start,npx vibe-kanban (or bash scripts/vibe-kanban-start.sh)
  2,CreateTask,Create a card on the board: title + description + agent selection
  3,Run,Drag a card to In Progress -> auto-start worktree + agent
  4,Review,Check diffs in the Review column -> approve or retry -> create PR
  5,MCP,Enable MCP server with --mcp flag -> agents can manipulate cards via API
R[5]:
  Keep card scope narrow (1 card = 1 commit)
  For tasks changing 2+ files, review the plan first with planno
  Use VIBE_KANBAN_REMOTE=true only on trusted networks
  If an agent stalls, reassign or split the card
  In MCP mode, control binding with MCP_HOST/MCP_PORT environment variables
E[4]{desc,in,out}:
  "Start server","npx vibe-kanban","Open board UI at http://localhost:3000"
  "Run agent","Drag card to In Progress","Create git worktree + run agent CLI + stream logs"
  "Create PR","Approve in Review column","Auto-create GitHub Draft PR + move card to Done"
  "MCP server","npx vibe-kanban --mcp","Expose card CRUD API via MCP protocol"
  "OpenCode ulw integration","Load ulw keyword + vibe-kanban then invoke task(category=\"visual-engineering\", run_in_background=True, ...) in parallel","Show concurrent Running status across 3 workspace Kanban boards"
T[3]{problem,solution}:
  "Worktree conflict","git worktree prune && git worktree list"
  "403 CORS error","Set VK_ALLOWED_ORIGINS=https://your-domain.com"
  "Port conflict","PORT=3001 npx vibe-kanban or lsof -i :3000"

PORT=3000
VIBE_KANBAN_REMOTE=false
VIBE_KANBAN_DATA_DIR=.vibe-kanban

MCP_HOST=127.0.0.1
MCP_PORT=3001

VK_ALLOWED_ORIGINS=http://localhost:3000

ANTHROPIC_API_KEY=sk-ant-api...
OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=AI...
GITHUB_TOKEN=ghp_...

{
  "mcpServers": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["vibe-kanban", "--mcp"],
      "env": {
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "3001"
      }
    }
  }
}

version: '3.8'

services:
  vibe-kanban:
    image: vibekanban/vibe-kanban:latest
    container_name: vibe-kanban
    ports:
      - "3000:3000"
      - "3001:3001"
    environment:
      - PORT=3000
      - MCP_PORT=3001
      - VIBE_KANBAN_REMOTE=true
      - VK_ALLOWED_ORIGINS=${VK_ALLOWED_ORIGINS:-http://localhost:3000}
    volumes:
      - ./data:/app/.vibe-kanban
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    container_name: vibe-kanban-proxy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./certs:/etc/nginx/certs:ro
    depends_on:
      - vibe-kanban
    restart: unless-stopped