Kodex (VS Code 확장)

터미널 없이, VS Code 안에서 바로 코드 리뷰와 블로그 학습 Q&A를 받을 수 있는 확장이에요. CLI 버전인 kodex-code-review-agent와 같은 Gemini API·같은 로직을 쓰지만, 결과를 예쁜 화면(웹뷰 패널)으로 보여줘요. 터미널이 편하면 CLI를, 화면으로 보고 싶으면 이 확장을 쓰면 돼요.

🎉 VS Code 마켓플레이스에 정식 배포되었어요.

설치 및 실행

1. VS Code 왼쪽 사이드바에서 확장 아이콘 클릭 (또는 Cmd + Shift + X)
2. "Kodex" 검색 → Kodex Code Review (게시자: doyu) → Install
3. Cmd + , (설정) 열고 "kodex"로 검색 → Gemini Api Key에 발급받은 키 입력
4. 아무 코드 파일을 열고 (또는 리뷰받고 싶은 부분만 드래그해서 선택하고) Cmd + Shift + P → "Kodex: 코드 리뷰 실행" 선택 → 단축키 Cmd + Alt + R로도 바로 실행돼요.
5. 오른쪽에 리뷰 결과 패널이 뜹니다.

git diff만 리뷰하기 (v0.0.2+)

파일 전체가 아니라 지금 작업 중인 변경사항만 PR 리뷰처럼 받고 싶을 때 써요. CLI의 review.py --diff와 동일한 로직이에요.

1. Cmd + Shift + P → "Kodex: git diff 리뷰 실행" 선택
2. "전체 변경사항" / "스테이징된 변경사항만" 중 선택
3. 오른쪽에 리뷰 결과 패널이 뜹니다 (변경사항이 없으면 알림으로 안내해요)

개발자용: 소스에서 직접 빌드해서 실행하기

코드를 직접 고치면서 테스트하고 싶으면, 마켓플레이스 설치 대신 이 저장소를 "개발 모드"로 실행할 수 있어요.

1. 이 폴더(kodex-vscode-extension)를 VS Code로 엽니다.
2. 터미널에서 의존성 설치:

   npm install
   npm run compile
   

3. VS Code 상단 메뉴에서 Run > Start Debugging (또는 F5)을 누릅니다. → "Extension Development Host"라는 새 VS Code 창이 뜹니다. 이 창에서만 개발 중인 코드가 동작해요.
4. 이후 단계는 위 "설치 및 실행"의 3번부터 동일해요.

블로그에 질문하기 (RAG)

먼저 CLI(kodex-code-review-agent)에서 python fetch_posts.py <아이디> → python build_index.py를 실행해서 embeddings.json을 워크스페이스 루트에 만들어둬야 해요.

1. Cmd + Shift + P → "Kodex: 블로그에 질문하기" 선택
2. 입력창에 질문 입력 (예: "코드 리뷰 CLI는 어떤 모델을 써?")
3. 오른쪽 패널에 답변 + 참고한 글 목록이 뜹니다

embeddings.json 위치가 다르면 설정(kodex.embeddingsPath)에서 경로를 바꿀 수 있어요. 질문과 가장 비슷한 글의 유사도가 너무 낮으면(기본 0.5 미만) Gemini를 호출하지 않고 "블로그에 아직 그 내용은 없어요"라고 바로 답해요 — 기준은 설정(kodex.minConfidence)에서 조정할 수 있어요.

오늘 API 사용량 보기

Cmd + Shift + P → "Kodex: 오늘 API 사용량 보기" — 워크스페이스 루트의 usage.json(CLI의 usage.py와 같은 파일)을 읽어서 오늘 몇 번 호출했는지 알림으로 보여줘요.

동작 방식

• 코드 리뷰: 코드를 드래그해서 선택했으면 선택한 부분만, 선택 안 했으면 파일 전체를 리뷰 대상으로 보내요. kodex-code-review-agent의 review.py와 동일한 프롬프트를 사용해서 항상 "📊 코드 품질 점수 / 🐛 발견된 버그 / 💡 개선 제안 / ✅ 잘한 점" 형식으로 답해요.
• git diff 리뷰: 워크스페이스 루트에서 git diff(또는 --staged)를 실행해서 나온 결과를 리뷰 대상으로 보내요. +/- 접두어가 붙은 변경된 줄 위주로 봐달라고 프롬프트에 명시하는 것까지 review.py --diff와 동일해요.
• 블로그 Q&A: 질문을 Gemini 임베딩 API로 벡터화하고, embeddings.json에 저장된 글 조각들과 코사인 유사도를 비교해서 가장 관련 있는 내용을 찾아요. 그 내용을 근거로 Gemini가 답하고, 어떤 글에서 가져왔는지 출처도 같이 보여줘요. kodex-code-review-agent의 ask.py와 같은 구조예요.
• 사용량 기록: Gemini API를 호출할 때마다(생성/임베딩 각각) 워크스페이스의 usage.json에 오늘 날짜로 카운트를 남겨요. CLI와 같은 워크스페이스에서 쓰면 사용량이 자동으로 합산돼요.
• API 키는 VS Code 설정(kodex.geminiApiKey)에 저장돼요. 커밋되는 코드에는 키가 들어가지 않아요.

앞으로 할 일

• [x] 마켓플레이스에 정식 배포 (doyu.kodex-code-review v0.0.1)
• [x] 코드 리뷰 도우미 + 블로그 학습 AI(RAG) 통합
• [x] 리뷰/답변 결과를 파일로 저장하는 버튼 추가
• [x] 429/503 자동 재시도
• [x] 코드 품질 점수 + 블로그 Q&A 낮은 확신도 처리 + API 사용량 카운터
• [x] .vscodeignore 추가해서 패키지에 개발용 파일(src, .vscode 등) 제외하기
• [x] git diff 리뷰 명령어 추가 (v0.0.2, CLI의 --diff와 동일한 로직)