Codex Git Commit Message Generator

Generate clean, conventional commit messages from your current Git diff directly in the VS Code Source Control input box.

Why this extension

Writing good commit messages takes context switching. This extension reads staged and unstaged changes, asks Codex to propose a concise single-line message, and inserts it where you already commit.

Features

• Generates a commit message from current Git changes.
• Works from Source Control title action and Command Palette.
• Inserts output directly into the SCM commit input box.
• Uses conventional commit style (feat, fix, chore, etc.).
• Gracefully falls back to a safe generic message if Codex CLI is unavailable.

Requirements

• VS Code 1.85.0 or newer
• Git available in your shell
• Codex CLI (codex) available in PATH for AI-generated messages

If Codex CLI is not found or fails, the extension still returns a fallback message based on changed files.

Platform support

• macOS (darwin)

Source Control title button

Open the Source Control view and click the sparkle button in the title bar to run Generate Commit Message and fill the commit input automatically.

Usage

1. Open a Git repository in VS Code.
2. Make staged and/or unstaged changes.
3. Run Generate Commit Message:
   • Source Control view title action, or
   • Command Palette (Cmd/Ctrl+Shift+P)
4. Review and commit.

Command

• Generate Commit Message (thewebmonk.git.generateCommitMessage)

How it works

1. Reads both staged and unstaged diffs.
2. Builds a strict prompt for a single-line conventional commit message.
3. Runs codex exec and captures the last message.
4. Writes the result to the SCM input.
5. If Codex is unavailable, falls back to:
   • chore: update <file> for one file
   • chore: update <N> files for multiple files
   • chore: update repository when no file details are available

Troubleshooting

• No git repository is available
  • Open a folder that contains a .git repository.
• Failed to run Codex
  • Ensure codex is installed and reachable from terminal (command -v codex).
• Empty or unexpected message
  • Check repository diff state and retry after staging relevant changes.

License

MIT