Git-rewrite-commits
lastmod 2026-11-16created 2025-11-263 edits
git-rewrite-commits는 git 커밋 이력을 AI 로 다시 읽어 Conventional Commits 형식(feat, fix, chore 등)의 커밋 메시지로 고쳐 쓰는 명령줄 도구이다. 커밋마다 바뀐 파일 목록과 diff 를 OpenAI GPT 나 로컬 Ollama 모델에 보내 메시지를 만든 뒤 이력을 다시 쓰므로 커밋 해시가 바뀐다. 그래서 README 는 공유 브랜치나 이미 다른 사람이 받아 간 커밋에는 쓰지 말고, 공개 전 개인 프로젝트나 머지 전 기능 브랜치를 정리할 때 쓰라고 권한다.
About
-
npx git-rewrite-commits(짧은 이름npx grec)로 설치 없이 실행. Windows·macOS·Linux 지원 -
--dry-run으로 결과를 미리 보고,--max-commits N으로 최근 N개만 처리함. 다시 쓰기 전에 백업 브랜치를 만듦 - 이미 형식을 갖춘 커밋은 건너뛰고 품질 점수로 고칠 커밋을 고름. 템플릿(
--template), 출력 언어(--language), 프롬프트(--prompt) 지정 가능 - 프로젝트 루트·
.git·.github의COMMIT_MESSAGE.md에 프로젝트별 커밋 규칙을 적으면 AI 가 따름 - git hook 연동:
pre-commit은 AI 메시지를 미리 보여 주고,prepare-commit-msg는 편집기에 메시지를 채움. 둘 다 git config 로 직접 켜야 동작 -
--staged로 스테이징된 변경의 커밋 메시지만 만들 수도 있음 - OpenAI 를 쓰면 diff 가 외부로 나가므로 먼저 동의를 받고, API 키·비밀번호·개인 키는 자동으로 가림. Ollama 를 쓰면 로컬에서만 처리
- MIT 라이선스