AI Commits
스테이지된 변경을 읽고 커밋 메시지를 써 주는 CLI
npm install -g aicommits깃 커밋 메시지를 대신 씁니다. 스테이지한 변경을 읽고 제안을 내놓으면 고르거나 고쳐서 넘어갑니다. 설치 후 설정 명령 한 번이면 제공자와 키, 모델, 메시지 형식이 정해집니다. 형식은 평문과 컨벤셔널, 컨벤셔널에 본문 추가, 지트모지, 제목과 본문 중에서 고릅니다. 제공자는 여러 상용 API 와 함께 올라마와 LM 스튜디오 같은 로컬 실행도 지원합니다. 로컬을 쓰면 API 키 없이 돌릴 수 있습니다. 노드 22 이상이 필요합니다.
판단
이럴 때 씁니다
- 커밋 메시지 쓰는 데 시간을 쓰기 싫을 때
- 팀 커밋 형식을 일관되게 맞추고 싶을 때
- 로컬 모델로만 돌리고 싶을 때
이럴 땐 쓰지 마세요
- 왜 바꿨는지가 중요한 커밋은 사람이 써야 합니다
- 변경이 크면 메시지가 뭉뚱그려집니다
- 노드 22 미만에서는 안 돕니다
차별점
- 설정 명령 하나로 제공자와 모델, 형식이 정해집니다.
- 평문과 컨벤셔널, 지트모지 등 다섯 가지 형식을 고릅니다.
- 상용 API 와 로컬 실행을 같은 방식으로 지원합니다.
- 지원되는 제공자에서는 모델 목록을 자동으로 가져옵니다.
워크플로
- 01전역으로 설치합니다.
- 02설정 명령으로 제공자와 키, 형식을 정합니다.
- 03변경을 스테이지합니다.
- 04명령을 실행해 제안을 받습니다.
- 05고르거나 고쳐서 커밋합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g aicommits | 설치합니다. |
aicommits setup | 제공자와 키, 모델, 메시지 형식을 정합니다. |
aicommits | 스테이지된 변경으로 메시지를 만듭니다. |
함정
설치 전에 확인하세요
- 노드 22 이상이 필요합니다.
- 스테이지한 변경만 봅니다. 스테이지를 안 하면 아무것도 못 씁니다.
- 변경이 크면 무엇을 왜 바꿨는지가 뭉개집니다. 커밋을 잘게 나누는 편이 낫습니다.
- 로컬 실행을 고르면 키가 필요 없지만 모델을 직접 띄워야 합니다.
비교
커밋 메시지 도구는 대개 제공자 하나에 묶여 있습니다. 이쪽은 제공자와 형식을 설정으로 바꾸는 구조라 팀 규칙에 맞추기 쉽습니다. 다만 변경의 이유는 여전히 사람이 알고 있어야 합니다.
최근 변경
4.2.2 는 2026년 9월 4일에 나온 패치 판입니다. 저장소가 변경 요약을 따로 적지 않고 비교 링크만 남겨 두어 실제 내용은 커밋 목록으로 확인합니다.