lazycommit

AI-powered Git commit message generator that analyzes your staged changes and outputs conventional commit messages.

Features

• Generates 10 commit message suggestions from your staged diff
• Providers: GitHub Copilot (default), OpenAI, OpenRouter
• Interactive config to pick provider/model and set keys
• Simple output suitable for piping into TUI menus (one message per line)

Installation

go install github.com/m7medvision/lazycommit@latest

Or build from source:

git clone https://github.com/m7medvision/lazycommit.git
cd lazycommit
go build -o lazycommit main.go

CLI

• Root command: lazycommit
• Subcommands:
  • lazycommit commit — prints 10 suggested commit messages to stdout, one per line, based on git diff --cached.
  • lazycommit config get — prints the active provider and model.
  • lazycommit config set — interactive setup for provider, API key, and model.

Exit behaviors:

• If no staged changes: prints "No staged changes to commit." and exits 0.
• On config/LLM errors: prints to stderr and exits non‑zero.

Examples

Generate suggestions after staging changes:

git add .
lazycommit commit

Pipe the first suggestion to commit (bash example):

MSG=$(lazycommit commit | sed -n '1p')
[ -n "$MSG" ] && git commit -m "$MSG"

Pick interactively with fzf:

git add .
lazycommit commit | fzf --prompt='Pick commit> ' | xargs -r -I {} git commit -m "{}"

Configuration

• Config directory (~/.config/.lazycommit.yaml

active_provider: copilot # default if a GitHub token is found
providers:
  copilot:
    api_key: "$GITHUB_TOKEN"   # Uses GitHub token; token is exchanged internally
    model: "gpt-4o"            # or "openai/gpt-4o"; both accepted
  openai:
    api_key: "$OPENAI_API_KEY"
    model: "gpt-4o"
    base_url: "https://api.openai.com/v1"  # optional custom endpoint
  openrouter:
    api_key: "$OPENROUTER_API_KEY" # or a literal key
    model: "openai/gpt-4o"         # OpenRouter model IDs, e.g. anthropic/claude-3.5-sonnet

Notes:

• Copilot: requires a GitHub token with models scope. The tool can also discover IDE Copilot tokens, but models scope is recommended.
• OpenAI: supports custom endpoints via base_url for OpenAI-compatible APIs (e.g., Azure OpenAI, local LLM servers)
• Environment variable references are supported by prefixing with $ (e.g., $OPENAI_API_KEY).

Configure via CLI

lazycommit config set     # interactive provider/model/key picker
lazycommit config get     # show current provider/model

Custom Endpoints

For the OpenAI provider, you can specify a custom base_url to use OpenAI-compatible APIs:

Examples:

Azure OpenAI:

providers:
  openai:
    api_key: "$AZURE_OPENAI_API_KEY"
    model: "gpt-4"
    base_url: "https://your-resource.openai.azure.com/openai/deployments/your-deployment/chat/completions"

Local LLM server (e.g., Ollama, LM Studio):

providers:
  openai:
    api_key: "dummy-key"  # some local servers require any non-empty key
    model: "llama2"
    base_url: "http://localhost:11434/v1"

The CLI config command will prompt for the base URL when selecting the OpenAI provider.

Integration with TUI Git clients

Because lazycommit commit prints plain lines, it plugs nicely into menu UIs.

Lazygit custom command

Add this to ~/.config/lazygit/config.yml:

customCommands:
  - key: "<c-a>" # ctrl + a
    description: "pick AI commit"
    command: 'git commit -m "{{.Form.Msg}}"'
    context: "files"
    prompts:
      - type: "menuFromCommand"
        title: "ai Commits"
        key: "Msg"
        command: "lazycommit commit"
        filter: '^(?P<raw>.+)$'
        valueFormat: "{{ .raw }}"
        labelFormat: "{{ .raw | green }}"

Tips:

• For lazycommit commit, you can omit filter and just use valueFormat: "{{ .raw }}" and labelFormat: "{{ .raw | green }}".
• If you pipe a numbered list tool (e.g., bunx bunnai), keep the regex groups number and message as shown.

Providers and models

• Copilot (default when a GitHub token is available): uses gpt-4o unless overridden. Accepts openai/gpt-4o and normalizes it to gpt-4o.
• OpenAI: choose from models defined in the interactive picker (e.g., gpt‑4o, gpt‑4.1, o3, o1, etc.).
• OpenRouter: pick from OpenRouter-prefixed IDs (e.g., openai/gpt-4o, anthropic/claude-3.5-sonnet). Extra headers are set automatically.

How it works

• Reads git diff --cached.
• Sends a single prompt to the selected provider to generate 10 lines.
• Prints the lines exactly, suitable for piping/selecting.

Troubleshooting

• "No staged changes to commit." — run git add first.
• "API key not set" — set the appropriate key in .lazycommit.yaml or env var and rerun.
• Copilot errors about token exchange — ensure your GitHub token has models scope or is valid; try setting GITHUB_TOKEN.

License

MIT