# git-rewrite-commits - AI로 Git 커밋 메시지를 자동 재작성하는 도구

> Clean Markdown view of GeekNews topic #24613. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=24613](https://news.hada.io/topic?id=24613)
- GeekNews Markdown: [https://news.hada.io/topic/24613.md](https://news.hada.io/topic/24613.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-11-26T09:31:01+09:00
- Updated: 2025-11-26T09:31:01+09:00
- Original source: [github.com/f](https://github.com/f/git-rewrite-commits)
- Points: 31
- Comments: 0

## Summary

**AI가 Git 히스토리를 읽고 커밋 메시지를 재작성**해주는 도구로, 오픈소스 프로젝트를 공개하기 전이나 PR 직전에 **히스토리를 깔끔하게 정리**하고 싶은 개발자에게 특히 유용합니다. **Conventional Commits 규칙**, **스마트 필터링**, **품질 점수 시스템**을 통해 이미 잘 작성된 커밋은 건너뛰고, 개선이 필요한 부분만 정교하게 다듬습니다. **Git Hooks**와 **CI/CD 통합**으로 워크플로우에 자연스럽게 녹아들며, **로컬 LLM(Ollama)** 지원 덕분에 코드 유출 걱정 없이 사용할 수 있습니다.

## Topic Body

- git 히스토리 전체를 **AI가 읽고 이해한 뒤**, 더 나은 **Conventional Commits 형식**으로 자동 재작성해주는 도구  
- 오픈소스 공개 전 정리, 팀 PR 올리기 전 마지막 폴리싱, 개인 프로젝트 커밋 청소 등 **깔끔한 히스토리가 필요할 때** 유용  
- OpenAI·Ollama 모두 지원하며, **로컬 LLM(Ollama)** 사용 시 코드 diff가 외부로 나가지 않게 가능   
- **Git Hooks 통합 지원**으로 커밋 시점에 **AI가 커밋 메시지를 자동 추천·자동 생성**하도록 설정 가능   
  - `pre-commit` 훅: 커밋 전 AI 제안 미리보기  
  - `prepare-commit-msg` 훅: 승인된 메시지 자동 적용  
  - 각 훅은 **opt-in 방식**으로 보안 설정 필요  
- **전문 워크플로우 지원**  
  - **스마트 필터** : 흠잡힌 메시지만 골라 개선하는 **스마트 필터링**을 통해 이미 잘 작성된 커밋은 건너뜀   
  - 모든 작업 전 **백업 브랜치 자동 생성**으로 복구 가능  
  - dry-run: `--dry-run`으로 변경 전 미리보기, `--max-commits`로 처리 범위 제한  
  - **품질 점수(quality scoring)** 기능으로 개선이 필요한 커밋 식별   
  - **사용자 정의 템플릿**과 `COMMIT_MESSAGE.md`를 통한 팀별 규칙 반영  
    - 프로젝트 루트, `.git`, `.github` 디렉터리에서 자동 탐색   
  - **CI/CD 파이프라인 통합**으로 PR 검증 시 커밋 품질 점검 가능  
  - **효율적 처리 구조**로 실시간 진행률 표시 및 컬러 출력 지원  
- **MIT 라이선스**  
- **주의사항**  
  - Git 히스토리 재작성은 커밋 해시를 변경하므로 **공유 브랜치에서는 비추천**  
  - 개인 프로젝트나 오픈소스 공개 전 정리 단계에서 사용 권장  
  - 팀 협의 없이 main/master 브랜치에 적용 금지

## Comments



_No public comments on this page._