🧠 Commit AI - Intelligent Conventional Commit Generator

Generate clean, consistent, and meaningful Conventional Commits using artificial intelligence.

A simple, fast, and developer-friendly API that converts code changes (diffs) into high-quality commit messages.

✨ Features

• 🧩 AI-powered commit generation based on diffs or descriptions
• 🎯 Follows the Conventional Commits specification
• 🔍 Automatically suggests commit type, scope, summary, and optional body
• ⚙️ User can force a specific commit type

🏗️ Tech Stack

• Node.js
• Fastify
• Zod
• OpenAI
• TypeScript

📦 Installation

git clone https://github.com/csendin/commit-ai

cd commit-ai

pnpm i

cp .env.example .env

Set your API key:

OPENAI_KEY=your_api_key_here

▶️ Running the project

pnpm dev

API available at: http://localhost:3333

🛠️ API Reference

POST /commit

Generate a Conventional Commit message.

Request Body

{
  "diff": "string",
  "type": "optional string"
}

Example

{
  "diff": "Added validation for user email in signup flow",
  "type": "feat"
}

Response

{
  "commit": "feat(auth): add email validation to signup flow"
}