@bluecode/cli

BlueCode CLI — AI 에이전트 팀이 코드를 검사하고 PR을 만들어주는 로컬 오케스트레이터.

설치

npm install -g @bluecode/cli

또는 설치 없이 바로:

npx @bluecode/cli init

명령어

bluecode init

프로젝트에 BlueCode를 설정합니다.

bluecode init [--force]

동작:

1. .bluecode/ 폴더 생성
2. config.json, rules/, workflows/ 기본 템플릿 주입
3. .gitignore에 민감 파일 패턴 추가
4. husky pre-push hook 설치 (git repo인 경우)

옵션:

| 옵션 | 설명 | |------|------| | -f, --force | 기존 .bluecode/가 있어도 재초기화 (config.json은 보존) |

bluecode push

현재 브랜치의 변경사항을 AI로 리뷰합니다.

bluecode push [--pr] [--dry-run] [--verbose] [--no-hook]

동작:

1. git diff main..HEAD 파싱
2. .bluecode/rules/에서 관련 규칙 RAG 검색
3. Code Reviewer 에이전트 실행
4. Approved → (옵션) Draft PR 생성
5. Rejected → 피드백 출력 + exit code 1 (pre-push hook에서 push 차단)

옵션:

| 옵션 | 설명 | |------|------| | --pr | 리뷰 통과 시 GitHub Draft PR 자동 생성 | | --dry-run | 실제 AI/GitHub API 호출 없이 흐름 확인 | | --verbose | 에이전트 메시지, 토큰 사용량 상세 출력 | | --no-hook | pre-push hook 모드 우회 |

종료 코드:

| 코드 | 의미 | |------|------| | 0 | 리뷰 통과 (Approved) | | 1 | 리뷰 실패 (Changes Requested) 또는 오류 |

bluecode ui

웹 대시보드를 로컬에서 실행합니다.

bluecode ui [--port <number>]

동작: localhost:3000에서 Next.js 앱 실행.

에이전트 워크플로우 시각화, 토큰 사용량, 리뷰 히스토리, config 편집 UI 제공.

옵션:

| 옵션 | 설명 | |------|------| | -p, --port <number> | 포트 번호 (기본값: 3000) |

설정

.bluecode/config.json 스키마:

{
  "models": {
    "diffAnalyzer": {
      "provider": "anthropic | openai | google",
      "modelId": "claude-3-5-haiku-20241022"
    },
    "codeReviewer": {
      "provider": "anthropic | openai | google",
      "modelId": "claude-3-5-sonnet-20241022"
    },
    "prWriter": {
      "provider": "anthropic | openai | google",
      "modelId": "claude-3-5-haiku-20241022"
    }
  },
  "apiKeys": {
    "anthropic": "sk-ant-...",
    "openai": "sk-...",
    "google": "AI..."
  },
  "github": {
    "token": "ghp_...",
    "owner": "your-org",
    "repo": "your-repo"
  },
  "workflow": {
    "timeoutMs": 120000
  }
}

주의: config.json은 .gitignore에 추가하세요. API 키가 포함됩니다.

팀 규칙 작성

.bluecode/rules/ 안에 마크다운 파일로 팀 규칙을 작성하면 RAG가 자동으로 관련 규칙을 리뷰에 주입합니다.

# .bluecode/rules/typescript.md

## 타입 규칙
- `any` 타입 사용 금지. `unknown` + 타입 가드 사용
- 모든 함수 파라미터와 반환 타입 명시
- default export 사용 금지

.bluecode/ 폴더를 git에 커밋하면 git pull만으로 팀 전체가 동일한 규칙을 공유합니다.

pre-push Hook

bluecode init 실행 시 husky pre-push hook이 자동 설치됩니다.

git push  →  bluecode push (자동 실행)  →  통과 시 push 진행 / 실패 시 차단

수동 우회: bluecode push --no-hook 또는 git push --no-verify

요구사항

• Node.js >= 22.0.0
• Git 저장소
• Anthropic / OpenAI / Google AI API 키 중 하나

License

MIT