빠른 시작

uvx gac init   # 프로바이더, 모델, 언어 구성
uvx gac  # LLM으로 생성 및 커밋

이게 전부입니다! 생성된 메시지를 검토하고 y로 확인하세요.

---

주요 기능

33+ 지원되는 프로바이더

• Anthropic • Azure OpenAI • Cerebras • ChatGPT (OAuth) • Chutes.ai • Claude Code (OAuth)
• Crof.ai • DeepInfra • DeepSeek • Fireworks • Gemini • GitHub Copilot (OAuth) • Groq
• Kimi for Coding • Lilac • LM Studio • MiniMax.io • Mistral AI • Moonshot AI • Neuralwatt • Ollama
• Ollama Cloud • OpenAI • OpenCode Go • OpenRouter • Plexus Gateway • Qwen Cloud (CN & INTL)
• Replicate • Streamlake/Vanchin • Synthetic.new • Together AI • Wafer.ai • Z.AI (API & Coding Plans)
• Custom Endpoints (Anthropic/OpenAI)

🧠 스마트 LLM 분석

• 의도 이해: 코드 구조, 로직, 패턴을 분석해 변경된 내용뿐 아니라 변경의 이유까지 이해
• 의미 인식: 리팩토링, 버그 수정, 기능, 호환성 깨지는 변경을 인식하여 맥락적으로 적절한 메시지 생성
• 지능적 필터링: 생성된 파일, 의존성, 아티팩트를 무시하면서 의미 있는 변경 우선순위 지정
• 지능적 커밋 그룹화 - --group을 사용하여 관련 변경을 여러 논리적 커밋으로 자동 그룹화

📝 다양한 메시지 형식

• 한 줄 요약 (-o 플래그): 컨벤셔널 커밋 형식을 따르는 한 줄 커밋 메시지
• 표준 (기본값): 구현 세부사항을 설명하는 불렛 포인트가 포함된 요약
• 상세 (-v 플래그): 동기, 기술적 접근 방식, 영향 분석을 포함한 포괄적인 설명
• 50/72 규칙 (--50-72 플래그): git log와 GitHub UI에서 최적의 가독성을 위해 클래식 커밋 메시지 형식 강제
• DCO/Signoff (--signoff 플래그): Developer Certificate of Origin 규정 준수를 위해 Signed-off-by 줄 추가 (Cherry Studio, Linux 커널 및 기타 프로젝트에서 필요)

🌍 다국어 지원

• 25+ 언어: 영어, 중국어, 일본어, 한국어, 스페인어, 프랑스어, 독일어 등 18+ 언어로 커밋 메시지 생성
• 유연한 번역: 도구 호환성을 위해 컨벤셔널 커밋 접두사를 영어로 유지하거나 완전히 번역
• 다양한 워크플로우: uvx gac language로 기본 언어 설정 또는 -l <language> 플래그로 일회성 재정의
• 네이티브 스크립트 지원: CJK, 키릴, 태국어 등 비라틴 스크립트 완전 지원

💻 개발자 경험

• 상호작용 피드백: r을 입력하여 재생성, e를 입력하여 편집 (기본적으로 인플레이스 TUI, 또는 $GAC_EDITOR가 설정된 경우 해당 에디터), 또는 더 짧게 만들어줘나 버그 수정에 집중해줘와 같이 피드백 직접 입력
• 상호작용 질문: --interactive (-i)를 사용하여 변경 사항에 대한 목표 질문에 답해 더 풍부한 컨텍스트를 담은 커밋 메시지 생성
• 한 번의 명령 워크플로우: uvx gac -ayp (모두 스테이징, 자동 확인, 푸시)와 같은 플래그로 완전한 워크플로우
• Git 통합: 비싼 LLM 작업 전에 pre-commit 및 lefthook hooks 실행
• MCP 서버: uvx gac serve를 실행하여 Model Context Protocol을 통해 AI 에이전트에 커밋 도구 제공

📊 사용 통계

uvx gac stats               # 개요: 총 gac 수, 연속 기록, 일일/주간 피크, 상위 프로젝트 및 모델
uvx gac stats models        # 모델별 세부 정보: gac 수, 토큰, 지연 시간, 속도, 커밋당 지연 시간 차트
uvx gac stats projects      # 프로젝트별 세부 정보: 모든 저장소의 gac 수, 커밋 수, 토큰 수, gac당 평균 파일 수
uvx gac stats recent        # 최근 gac 기록: gac당 토큰, 속도, 지연 시간, 파일 수 (-n 20으로 더 보기)
uvx gac stats reset         # 모든 통계 초기화 (확인 필요)
uvx gac stats reset model <model-id>  # 특정 모델의 통계만 초기화

• gac 사용 추적: gac으로 몇 번 커밋했는지, 현재 연속 사용 일수, 일일/주간 활동 피크, 상위 프로젝트 확인
• 토큰 추적: 일, 주, 프로젝트, 모델별 총 프롬프트 + 완료 토큰 — 토큰 사용량 하이 스코어 트로피 포함
• 상위 모델: 가장 많이 사용하는 모델과 각 모델의 토큰 소비량 확인
• 하이 스코어 축하: 🏆 새로운 일일, 주간, 토큰 또는 연속 기록을 세우면 트로피 획득; 🥈 기록과 타이면 획득
• 설정 시 옵트인: uvx gac init이 통계 활성화 여부를 묻고 저장되는 항목을 설명합니다
• 언제든 옵트아웃: GAC_DISABLE_STATS=true (또는 1/yes/on) 설정으로 비활성화. false/0/no로 설정 (또는 해제) 시 통계가 활성화 상태로 유지
• 개인정보 보호 우선: ~/.gac_stats.json에 로컬 저장. 카운트, 날짜, 프로젝트 이름, 모델 이름만 — 커밋 메시지, 코드, 개인 데이터는 저장하지 않습니다. 원격 측정 없음

🛡️ 내장 보안

• 자동 비밀 감지: 커밋 전에 API 키, 비밀번호, 토큰 스캔
• 상호작용 보호: 잠재적으로 민감한 데이터를 커밋하기 전에 명확한 수정 옵션으로 프롬프트
• 스마트 필터링: 예제 파일, 템플릿 파일, 플레이스홀더 텍스트를 무시하여 거짓 양성 감소

---

사용 예제

기본 워크플로우

# 변경 사항 스테이징
git add .

# LLM으로 생성하고 커밋
uvx gac

# 검토 → y (커밋) | n (취소) | r (재생성) | e (편집) | 또는 피드백 입력

일반 명령어

명령어	설명
uvx gac	커밋 메시지 생성
uvx gac -y	자동 확인 (검토 불필요)
uvx gac -a	커밋 메시지 생성 전 모두 스테이징
uvx gac -S	인터랙티브하게 스테이징할 파일 선택
uvx gac -o	사소한 변경을 위한 한 줄 메시지
uvx gac -v	동기, 기술적 접근 방식, 영향 분석이 포함된 상세 형식
uvx gac -h "hint"	LLM을 위한 컨텍스트 추가 (예: uvx gac -h "버그 수정")
uvx gac -s	스코프 포함 (예: feat(auth):)
uvx gac -i	변경에 대한 질문하여 더 나은 컨텍스트 얻기
uvx gac -g	변경 사항을 여러 논리적인 커밋으로 그룹화
uvx gac -p	커밋하고 푸시
uvx gac model	AI 공급자와 모델 변경
uvx gac stats	gac 사용 통계 보기

고급 사용자 예제

# 한 명령어로 완전한 워크플로우
# 커밋 통계 보기
uvx gac stats

# 모든 프로젝트의 통계
uvx gac stats projects

uvx gac -ayp -h "릴리스 준비"

# 스코프가 포함된 상세 설명
uvx gac -v -s

# 작은 변경을 위한 빠른 한 줄 요약
uvx gac -o

# 특정 언어로 커밋 메시지 생성
uvx gac -l ko

# 변경을 논리적으로 관련된 커밋으로 그룹화
uvx gac -ag

# 상세한 출력으로 상호작용 모드 사용한 상세한 설명
uvx gac -iv

# LLM이 보는 내용 디버깅
uvx gac --show-prompt

# 보안 스캔 건너뛰기 (주의해서 사용)
uvx gac --skip-secret-scan

# DCO 규정 준수를 위한 signoff 추가 (Cherry Studio, Linux 커널 등)
uvx gac --signoff

상호작용 피드백 시스템

결과가 마음에 들지 않으세요? 여러 옵션이 있습니다:

# 단순 재생성 (피드백 없음)
r

# 커밋 메시지 편집
e

# 또는 피드백을 직접 입력하세요!
더 짧게 만들고 성능 개선에 집중해줘
스코프가 포함된 컨벤셔널 커밋 형식 사용해줘
보안 영향 설명해줘

# 빈 입력에서 Enter를 눌러 프롬프트를 다시 보세요

편집 기능(e)으로 커밋 메시지를 다듬을 수 있습니다:

• 기본값 (인플레이스 TUI): vi/emacs 키바인딩으로 다중 라인 편집 — 오타 수정, 표현 조정, 재구성
• GAC_EDITOR 사용 시: 원하는 에디터(code, vim, nano 등) 열기 — 찾기/바꾸기, 매크로 등 에디터의 모든 기능 사용 가능

VS Code 같은 GUI 에디터는 자동으로 처리됩니다: gac이 --wait을 삽입하여 에디터 탭을 닫을 때까지 프로세스가 차단됩니다. 추가 설정이 필요 없습니다.

---

설정

상호작용적으로 프로바이더를 설정하려면 uvx gac init를 실행하거나 환경 변수를 설정하세요:

나중에 언어 설정을 건드리지 않고 프로바이더나 모델을 변경해야 하나요? 언어 프롬프트를 건너뛰는 간소화된 흐름을 위해 uvx gac model을 사용하세요.

사용 가능한 모든 옵션은 .gac.env.example을 참조하세요.

다른 언어로 커밋 메시지를 원하시나요? uvx gac language를 실행하여 Español, Français, 日本語 등 25+ 언어 중에서 선택하세요.

커밋 메시지 스타일을 사용자 정의하고 싶으신가요? 사용자 정의 시스템 프롬프트 작성에 대한 안내는 docs/CUSTOM_SYSTEM_PROMPTS.md를 참조하세요.

---

도움말 얻기

• 전체 문서: docs/USAGE.md - 완전한 CLI 참조
• MCP 서버: docs/MCP.md - AI 에이전트를 위한 MCP 서버로 GAC 사용
• Claude Code OAuth: docs/CLAUDE_CODE.md - Claude Code 설정 및 인증
• ChatGPT OAuth: docs/CHATGPT_OAUTH.md - ChatGPT OAuth 설정 및 인증
• 사용자 정의 프롬프트: docs/CUSTOM_SYSTEM_PROMPTS.md - 커밋 메시지 스타일 사용자 정의
• 사용 통계: uvx gac stats --help 또는 전체 문서를 참조하세요
• 문제 해결: docs/TROUBLESHOOTING.md - 일반적인 문제 및 해결책
• 기여: docs/CONTRIBUTING.md - 개발 설정 및 가이드라인

---