vibe-collab

누가 어떤 AI를 써도, 항상 한 팀처럼 작동하는 바이브 코딩 협업 도구

어떻게 작동하나요?

[내 PC]                                    [vibeorchestratorserver.vercel.app]
  vibe auth login
    → 브라우저 GitHub 로그인 ──────────────→ GitHub OAuth
    ← JWT 토큰 발급 ←──────────────────────
    → ~/.vibe/auth.json 저장

  Claude Code / Cursor / Gemini CLI / Antigravity ...
    → MCP 도구 호출 (vibe_start_session 등)
    → AI 요청 ──────────────────────────→ /api/ai/complete (JWT 인증)
    ← AI 응답 ←────────────────────────── Anthropic API 호출 후 반환

• AI API 키 불필요 — 서버(vibeorchestratorserver.vercel.app)가 관리합니다
• GitHub 로그인 한 번 — 이후 모든 AI 기능 자동 사용
• 10개 MCP 도구 — git commit/push까지 AI가 직접 실행, 사용자는 채팅만

빠른 시작

프로젝트 팀장 (최초 1회)

npm install -g vibe-collab

vibe auth login          # GitHub 로그인
cd /path/to/your/project
vibe init                # CHARTER.md + .vibe/ 생성
vibe connect             # AI 도구 자동 감지 + MCP 설정

git add .vibe CHARTER.md
git commit -m "chore: init vibe"
git push

새 협업자 합류 (최초 1회)

npm install -g vibe-collab

git clone <repo-url>     # .vibe/ 폴더도 함께 옴
vibe auth login          # 본인 GitHub 계정으로 로그인
vibe connect             # AI 도구에 MCP 설정 추가

vibe init은 다시 실행하지 않아도 됩니다. .vibe/config.json과 CHARTER.md는 이미 레포에 있습니다.

매일 작업 (자동)

AI 채팅창 열기
→ AI가 vibe_start_session 자동 호출 (팀 현황 파악)
→ "~~ 기능 추가해줘" 요청
→ AI가 vibe_analyze_request → vibe_start_work 자동 진행
   (기존 이슈 브랜치면 git fetch + checkout + pull도 자동)
→ 코드 작업 → vibe_record_checkpoint → vibe_git_push
   (git commit & push도 AI가 MCP를 통해 자동 실행)

git pull, vibe init, vibe start 같은 명령어를 매번 실행할 필요 없습니다.

CLI 명령어

| 명령어 | 설명 | |--------|------| | vibe auth login | GitHub OAuth 로그인 | | vibe auth logout | 로그아웃 | | vibe auth status | 로그인 상태 및 만료일 확인 | | vibe init | 프로젝트 초기화 — 팀장이 최초 1회만 실행 | | vibe connect | AI 도구 자동 감지 후 MCP 설정 추가 | | vibe connect --ai <tool> | 특정 AI 도구에 MCP 설정 추가 | | vibe status | 팀 현황 출력 | | vibe serve | MCP 서버 시작 (AI 도구에서 자동 실행됨) |

vibe connect 지원 도구

| 명령어 | 도구 | 설정 파일 | |--------|------|-----------| | vibe connect --ai claude | Claude Code | .claude/settings.json | | vibe connect --ai cursor | Cursor | .cursor/mcp.json | | vibe connect --ai vscode | VS Code | .vscode/mcp.json | | vibe connect --ai copilot | Copilot | .vscode/mcp.json | | vibe connect --ai kiro | Kiro | .kiro/settings/mcp.json | | vibe connect --ai roocode | Roo Code | .roo/mcp.json | | vibe connect --ai trae | Trae | .trae/mcp.json | | vibe connect --ai continue | Continue | .continue/mcpServers/mcp.json | | vibe connect --ai windsurf | Windsurf | ~/.codeium/windsurf/mcp_config.json (전역) | | vibe connect --ai gemini | Gemini CLI | ~/.gemini/settings.json (전역) | | vibe connect --ai antigravity | Antigravity | ~/.gemini/antigravity/mcp_config.json (전역) | | vibe connect --ai all | 위 전체 | — |

Windsurf / Gemini CLI / Antigravity: 전역 설정에 기록됩니다. --cwd <프로젝트 경로>가 자동으로 주입되어 어느 디렉토리에서 실행해도 올바른 프로젝트를 찾습니다.

MCP 도구 (10개)

Claude Code, Cursor, Gemini CLI 등 MCP를 지원하는 모든 AI 도구에서 사용할 수 있습니다.

| 도구 | 설명 | |------|------| | vibe_start_session | 세션 시작 — CHARTER, 팀 현황, 워크플로우 규칙 반환 | | vibe_analyze_request | 요청 분석 → 관련 이슈 연결 또는 신규 제안, 이전 대화 기록 복원 | | vibe_start_work | 작업 시작 — 기존 브랜치면 자동 checkout+pull, 신규면 브랜치 생성 | | vibe_record_checkpoint | 단계 완료 기록 (code_complete, qa_passed 등) | | vibe_git_push | git add -A → commit → push 자동 실행 (state.json 포함) | | vibe_save_context | 결정/진행 상황/피드백을 이슈별로 저장 → 다음 세션에서 자동 복원 | | vibe_request_qa | 코드 리뷰 (정적 분석 + AI 검사) | | vibe_create_pr | PR 자동 생성 | | vibe_request_merge_review | 머지 전 충돌 검사 | | vibe_execute_merge | Squash merge + CHARTER 자동 갱신 |

AI가 따르는 워크플로우

① 사용자 요청 → vibe_analyze_request
② 작업 확정   → vibe_start_work (기존 브랜치 자동 checkout+pull)
③ 코드 완료   → vibe_record_checkpoint(stage: "code_complete")
④ 커밋+푸시   → vibe_git_push (state.json 포함 전체 자동)
⑤ 코드 검토   → vibe_request_qa
⑥ 검토 통과  → vibe_create_pr

세션 간 대화 기록 유지 (vibe_save_context)

AI가 중요한 결정이나 피드백을 .vibe/logs/{issueNumber}.md에 저장합니다.

# 이슈 #5 작업 로그

## [2026-03-01 14:30] alice (claude-code) — 결정
JWT 방식 채택. Session 방식은 서버 부하 문제로 기각.

## [2026-03-02 09:00] bob (gemini-cli) — 사용자 피드백
에러 메시지를 더 친절하게 바꿔달라고 함.

같은 이슈를 다음 세션이나 다른 AI 에이전트가 이어받을 때, vibe_analyze_request가 이 기록을 자동으로 읽어서 컨텍스트에 포함합니다.

여러 AI 동시 협업 예시

[Claude Code — alice]               [Gemini CLI — bob]
vibe_start_session                  vibe_start_session
→ 이슈 #5 담당                       → 이슈 #6 담당

코드 수정                            코드 수정
vibe_record_checkpoint               vibe_record_checkpoint
vibe_git_push                        vibe_git_push

두 세션이 동일한 .vibe/state.json 공유 → 충돌 없이 병렬 개발

협업 시 .vibe 폴더 관리

.vibe/ 폴더는 반드시 Git으로 관리해야 합니다.

.vibe/
  config.json      ← GitHub 레포 정보 (vibe init 1회)
  state.json       ← 팀 협업 상태 (매 작업마다 업데이트)
  intents/         ← 이슈별 분석 기록
  logs/            ← 이슈별 대화 기록 (vibe_save_context)
CHARTER.md         ← 레포 컨벤션 (vibe init 1회, merge 시 자동 갱신)

state.json은 vibe_git_push가 자동으로 커밋에 포함합니다.

프록시 서버

AI 요청은 https://vibeorchestratorserver.vercel.app 을 통해 처리됩니다.

• /api/ai/complete — JWT 인증 후 Anthropic API 호출
• /api/auth/cli-token — GitHub OAuth 후 CLI 토큰 발급

라이선스

MIT