"오늘의 기록이 내일의 이력서가 됩니다."

Claw-Log는 매일 밤 AI가 당신의 변경 사항을 스캔하여 기술적 의사결정과 트러블슈팅 과정을 마크다운 형식으로 자동 기록하는 CLI 도구입니다.

---

🧐 왜 기록해야 하나요?

매일 치열하게 코딩하지만, 정작 성과 공유나 이력서를 업데이트할 때 커밋 로그만 뒤적거리며 머리를 쥐어짜고 있지는 않나요?

fix: bug, refactor: code 같은 파편화된 기록으로는 당신의 진짜 고민과 실력을 보여줄 수 없습니다. Claw-Log는 LLM(Large Language Model)이 git diff를 직접 분석해 당신이 고민한 흔적을 추출합니다. 매일 조금씩 쌓인 이 기록들은 훗날 이력서 정리나 기술 면접 시 가장 강력한 데이터가 됩니다.

---

✨ 핵심 기능

• AI 기반 자동 요약: 단순 커밋 메시지가 아닌, 실제 코드 변화에서 기술적 맥락을 AI가 파악합니다.
• 통합 프로젝트 관리: 여러 폴더에 흩어진 프로젝트 성과를 한 곳에 모아 관리합니다.
• 기록의 자산화: 매일 기록된 로그는 로컬에 누적됩니다. 나중에 한 번에 모아 이력서나 기술 블로그의 초안으로 활용하세요.
• 프라이버시 보장: 소스코드를 외부 서버에 저장하지 않습니다. 모든 분석은 로컬 환경에서 수행됩니다.
• 유연한 설정: claw-log --reset 명령으로 언제든 프로젝트 경로나 API 설정을 변경할 수 있습니다.

---

🛠 설치 및 설정

1. 설치 (Recommended)

파이썬 환경 격리를 위해 pipx 사용을 권장합니다.

pipx install claw-log

2. 초기 설정 및 실행

터미널에서 명령어를 입력하면 설정 마법사가 시작됩니다.

claw-log

3. 설정 변경

API 키를 갱신하거나 프로젝트 경로를 수정하고 싶다면 아래 명령어를 입력하세요.

claw-log --reset

---

📦 요약 샘플 (Output Sample)

AI 특유의 과장된 표현을 배제하고, 실제 개발 과정에서의 의사결정을 담백하게 기록합니다.

### 📂 [my-frontend] - 2026-02-10
> **Summary**: 전역 에러 핸들링 구조 설계 및 런타임 보안 강화

- **상세 내역**
  - `ServerErrorBoundary` 및 Axios 인터셉터를 결합한 전역 에러 처리 시스템 구축.
  - 5xx 서버 에러 및 네트워크 장애 발생 시 전역 에러 페이지 리다이렉션 로직 구현.
  - API BaseURL, 보안 키 등 민감 정보를 `process.env`로 분리하여 관리.
  - Axios 타임아웃(30s) 설정을 통해 지연 응답으로 인한 좀비 커넥션 방지.

- **핵심 불렛 포인트 (Resume Point)**
  - Error Boundary와 Axios Interceptor를 활용한 전역 에러 핸들링 아키텍처 설계로 서비스 안정성 개선.
  - 민감 정보 환경 변수화 및 타임아웃 정책 수립을 통한 애플리케이션 보안 최적화.

---

🔀 Fork 수정 내역 (dlwnstjr0310)

이 저장소는 WooHyucks/claw-log의 fork입니다.

Gemini CLI OAuth 인증 지원 추가

API Key 없이 Gemini CLI의 OAuth 인증(~/.gemini/oauth_creds.json)을 재활용하여 Gemini API를 호출할 수 있습니다.

변경 사항:

• GeminiOAuthSummarizer 클래스 추가 (engine.py)
  • Gemini CLI 설치 경로에서 client_id/client_secret을 런타임에 동적 추출 (소스코드에 노출 없음)
  • cloudcode-pa.googleapis.com REST API 직접 호출 (Gemini CLI와 동일한 엔드포인트)
  • 토큰 만료 시 refresh_token으로 자동 갱신
  • 프로젝트 ID 자동 조회 및 로컬 캐싱
• 설정 마법사에 [3] Google Gemini (OAuth) 옵션 추가 (main.py)
• 기본 모델: gemini-3-flash-preview

전제 조건:

• Gemini CLI 설치 (npm install -g @google/gemini-cli)
• Gemini CLI OAuth 로그인 완료 (gemini 실행 후 로그인)

설치:

pipx install git+https://github.com/dlwnstjr0310/claw-log.git --force

---

🛡 트러블슈팅

명령어를 찾을 수 없거나 라이브러리 충돌이 발생하나요? 최신 Python 버전 환경에서 기존 패키지 잔재가 남아있을 때 생기는 문제입니다. 아래 명령어로 깨끗하게 재설치하세요.

pipx install claw-log --force --no-cache-dir

---

💡 한마디

"이력서는 이직할 때 쓰는 것이 아닙니다. 매일의 기록을 모아 정리하는 것입니다."