Repolode
guanguans

guanguans/ai-commit

CLI-инструмент, который генерирует conventional commit-сообщения по staged diff с помощью AI-моделей и затем создаёт коммит.

Звёзды
393
Форки
22
Открытые issues
0
Последний коммит
4 дня назад

Что это?

ai-commit — консольный инструмент на PHP: он считывает git diff, отправляет его AI-генератору и формирует conventional commit-сообщение с типом, темой и описанием. Перед коммитом сообщение можно проверить и отредактировать, либо запустить dry run, чтобы только вывести результат.

Поддерживаются разные бэкенды: OpenAI, OpenAI Chat, Moonshot, ERNIE Bot, Bito CLI, GitHub Copilot CLI и GitHub Models CLI. Генератор по умолчанию и API keys настраиваются командой config. Также есть команды для просмотра доступных параметров, редактирования конфигурации и самостоятельного обновления собранного бинарного файла.

Установить инструмент можно, скачав из репозитория файл ai-commit, или через Composer. Требуется PHP версии 8.2 или новее.

Ключевые возможности

  • 01Генерирует conventional commit-сообщения по содержимому git diff.
  • 02Позволяет выбрать тип коммита и проверить сообщение перед его созданием.
  • 03Поддерживает несколько AI-бэкендов, в том числе OpenAI, Moonshot и ERNIE Bot.
  • 04Предусматривает режим dry run, который только выводит сгенерированное сообщение.
  • 05Распространяется одним скачиваемым файлом или устанавливается через Composer.

Сценарии использования

  • Составление единообразных сообщений коммитов в проектах, где принят формат Conventional Commits.
  • Ускорение создания коммитов при крупных изменениях, которые утомительно описывать вручную.
  • Генерация сообщений коммитов с помощью уже настроенных GitHub Copilot CLI или Bito CLI.

Быстрый старт

  1. 1

    Установите глобально через Composer (требуется PHP 8.2 или новее)

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

    Укажите 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?
CLI-инструмент, который генерирует conventional commit-сообщения по staged diff с помощью AI-моделей и затем создаёт коммит. ai-commit — консольный инструмент на PHP: он считывает git diff, отправляет его AI-генератору и формирует conventional commit-сообщение с типом, темой и описанием. Перед коммитом сообщение можно проверить и отредактировать, либо запустить dry run, чтобы только вывести результат.
ai-commit можно использовать бесплатно? Какая у него лицензия?
ai-commit распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ai-commit всё ещё поддерживается?
Активно поддерживается. Последний коммит в ai-commit — 3 нояб. 2026 г..
Для чего можно использовать ai-commit?
Составление единообразных сообщений коммитов в проектах, где принят формат Conventional Commits. Ускорение создания коммитов при крупных изменениях, которые утомительно описывать вручную. Генерация сообщений коммитов с помощью уже настроенных GitHub Copilot CLI или Bito CLI.
Как установить ai-commit?
Установите глобально через Composer (требуется PHP 8.2 или новее): composer global require guanguans/ai-commit --dev -v Укажите 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

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты