Repolode
Nutlope

Nutlope/aicommits

一个命令行工具,基于你选择的 AI 模型,根据暂存的代码改动自动生成 git 提交信息。

Star
9,125
Fork
483
未关闭 Issue
9
最近提交
11天前

这是什么?

AI Commits 是一个命令行工具,读取你已暂存的 git 改动并自动起草提交信息,省去手写 commit message 的步骤。它支持 TogetherAI、OpenAI、Groq、xAI、OpenRouter、Ollama、LM Studio 以及任何兼容 OpenAI 接口的服务,provider 和模型可通过交互式 setup 命令选择。

除默认的 plain 风格外,还可生成 Conventional Commits、带正文的 Conventional Commits、gitmoji 风格或带正文的主题。你也可以一次生成多条候选消息供挑选,添加描述,排除不需分析的文件,或用自定义 prompt 指定语言、语气等要求。

它既可以作为命令直接使用,未识别的参数会传给 git commit;也可以安装为 prepare-commit-msg 钩子,让生成的消息在编辑器中打开供审阅后再提交。配置可来自配置文件或环境变量,适合 CI/CD 场景。

核心功能

  • 01支持 TogetherAI、OpenAI、Groq、xAI、OpenRouter、Ollama、LM Studio 及兼容 OpenAI 接口的自定义端点。
  • 02提供 plain、conventional、conventional+body、gitmoji、subject+body 等提交信息格式。
  • 03可一次生成多条候选消息供选择。
  • 04可安装为 prepare-commit-msg Git 钩子,在提交前编辑消息。
  • 05支持自定义 prompt,控制消息语言或风格。
  • 06内置 update 命令,可自动识别 npm、pnpm、yarn 或 bun。

适用场景

  • 日常开发中快速为 git 仓库生成提交信息。
  • 在团队中无需手动操作即可统一 Conventional Commits 或 gitmoji 格式。
  • 通过环境变量在 CI/CD 流水线中生成提交信息。
  • 使用 Ollama 或 LM Studio 运行本地模型,让代码差异留在本机。

快速上手

  1. 1

    确认 Node.js 版本为 22 或更高

    node --version
  2. 2

    使用 npm 全局安装 aicommits

    npm install -g aicommits
  3. 3

    运行设置命令,选择 AI 提供商并配置 API 密钥

    aicommits setup
  4. 4

    暂存更改并生成提交信息

    aicommits

使用前须知

  • 需要 Node.js 22 或更高版本。
  • 大多数提供商需要 API 密钥,本地选项则需要在您的机器上运行模型。

收录于专题

标签

常见问题

aicommits 是什么?
一个命令行工具,基于你选择的 AI 模型,根据暂存的代码改动自动生成 git 提交信息。 AI Commits 是一个命令行工具,读取你已暂存的 git 改动并自动起草提交信息,省去手写 commit message 的步骤。它支持 TogetherAI、OpenAI、Groq、xAI、OpenRouter、Ollama、LM Studio 以及任何兼容 OpenAI 接口的服务,provider 和模型可通过交互式 setup 命令选择。
aicommits 可以免费使用吗?用的什么许可证?
aicommits 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
aicommits 还在维护吗?
活跃维护中。aicommits 最近一次提交是在 2026年10月27日。
aicommits 适合用来做什么?
日常开发中快速为 git 仓库生成提交信息。 在团队中无需手动操作即可统一 Conventional Commits 或 gitmoji 格式。 通过环境变量在 CI/CD 流水线中生成提交信息。 使用 Ollama 或 LM Studio 运行本地模型,让代码差异留在本机。
aicommits 怎么安装和运行?
确认 Node.js 版本为 22 或更高: node --version 使用 npm 全局安装 aicommits: npm install -g aicommits 运行设置命令,选择 AI 提供商并配置 API 密钥: aicommits setup 暂存更改并生成提交信息: aicommits
在哪里获取 aicommits?
源代码和安装说明在 GitHub 上:https://github.com/Nutlope/aicommits

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目