guanguans/ai-commit

어떤 프로젝트인가요?

핵심 기능

• 01git diff 내용을 바탕으로 Conventional Commits 형식의 메시지를 생성합니다.
• 02커밋 타입을 선택하고 커밋 전에 메시지를 검토할 수 있습니다.
• 03OpenAI, Moonshot, ERNIE Bot 등 여러 AI 백엔드를 지원합니다.
• 04생성된 메시지만 출력하는 dry-run 모드를 제공합니다.
• 05단일 파일을 다운로드하거나 Composer를 통해 설치할 수 있습니다.

활용 사례

• Conventional Commits 형식을 따르는 프로젝트에서 일관된 커밋 메시지를 작성할 때.
• 변경 사항이 많아 요약을 직접 작성하기 번거로울 때 커밋 작업을 빠르게 진행할 때.
• 기존 GitHub Copilot 또는 Bito CLI 설정을 활용해 커밋 메시지를 생성할 때.

빠른 시작

1. 1

   Composer를 사용해 전역으로 설치합니다(PHP 8.2 이상 필요).

   composer global require guanguans/ai-commit --dev -v
2. 2

   AI 생성기의 API 키를 설정합니다(예시에서는 OpenAI Chat 사용).

   ai-commit config set generators.openai_chat.api_key sk-... --global
3. 3

   변경 사항을 스테이징하고 메시지를 생성한 뒤 커밋합니다.

   ai-commit commit

사용 전 알아둘 점

• !PHP 8.2 이상이 필요합니다.
• !대부분의 생성기에는 API 키 또는 별도로 설치한 CLI 도구가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ai-commit은(는) 무엇인가요?

AI 모델로 스테이징된 diff에서 Conventional Commits 형식의 Git 커밋 메시지를 생성하고 커밋하는 CLI 도구입니다. ai-commit은 git diff를 읽어 AI 생성기에 전달하고, 타입·제목·본문으로 구성된 Conventional Commits 형식의 커밋 메시지를 만드는 PHP 명령줄 도구입니다. 커밋하기 전에 메시지를 검토하고 수정할 수 있으며, 결과만 출력하는 dry run도 지원합니다.

ai-commit은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ai-commit은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ai-commit은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ai-commit의 마지막 커밋은 2026년 11월 3일입니다.

ai-commit은(는) 어디에 사용할 수 있나요?

Conventional Commits 형식을 따르는 프로젝트에서 일관된 커밋 메시지를 작성할 때. 변경 사항이 많아 요약을 직접 작성하기 번거로울 때 커밋 작업을 빠르게 진행할 때. 기존 GitHub Copilot 또는 Bito CLI 설정을 활용해 커밋 메시지를 생성할 때.

ai-commit는 어떻게 설치하나요?

Composer를 사용해 전역으로 설치합니다(PHP 8.2 이상 필요).: composer global require guanguans/ai-commit --dev -v AI 생성기의 API 키를 설정합니다(예시에서는 OpenAI Chat 사용).: ai-commit config set generators.openai_chat.api_key sk-... --global 변경 사항을 스테이징하고 메시지를 생성한 뒤 커밋합니다.: ai-commit commit

ai-commit은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/guanguans/ai-commit