🐟

fish + fzfで作るマルチコードエージェント対応のコミットメッセージジェネレーター

に公開

はじめに

コミットメッセージを考えるのが面倒なので、AIに生成してもらうツールを作りました。
今まで既存のツールを使用していたのですが、たまに指定した言語にならなかったり、日本語にするとdocs: rEADME.mdを更新みたいに最初だけ小文字になったりして微妙だったので、自分で作ることにしました。

作ったもの

fish関数として実装したaicommitコマンドです。

主な機能

  • 複数のコードエージェント対応: Claude Code、Codex、Geminiの3つから選べる
  • メッセージ候補を3つ出してくれる: 1つに決め打ちじゃなくて選べるのが便利
  • fzfで選択: 言語、コードエージェント、コミットメッセージをfzfで選ぶ
  • APIキー管理不要: 各CLIツールの認証を使うので楽

使い方

依存ツールのインストール

必要なツールをインストールします。

# fzf
brew install fzf

# 使いたいコードエージェントCLIをインストール(全部入れる必要はない)
# それぞれ認証まで済ませておく
brew install --cask claude-code        # Claude Code
brew install codex                     # Codex
brew install gemini-cli                # Gemini

インストール

aicommit関数をfishのfunctionsディレクトリに配置します。

# functionsディレクトリがなければ作成
mkdir -p ~/.config/fish/functions

# aicommit.fishをダウンロード(そのまま使う場合)
curl -fsSL -o ~/.config/fish/functions/aicommit.fish \
  https://raw.githubusercontent.com/u1aryz/dotfiles/edef4baf60a686b81fe07f45836b334a1bb438a0/.fish/functions/aicommit.fish

# fishをリロード
exec fish

実行

git add .
aicommit

これだけです。あとは対話的に選んでいくだけ。

  1. 言語選択(日本語 or 英語)
  2. コードエージェント選択(Claude Code / Codex / Gemini)
  3. 生成された3つのメッセージから1つ選ぶ
  4. 自動でコミット完了

実装の要点

全体で150行もないので、お好みで変更してください。

コードエージェントごとのモデル指定

速度重視でモデルを指定しています。

claude --model sonnet -p <$prompt_file
gemini --model flash-lite <$prompt_file
codex --model codex-mini-latest exec - <$prompt_file

プロンプト

3つのConventional Commit形式のメッセージを生成してもらうようにしています。

set -l prompt "Analyze the following git diff and git status, then suggest 3 conventional commit messages $lang_instruction.

Each message should follow this format:
- type: subject format (no scope needed)
- type should be one of: feat, fix, docs, style, refactor, test, chore, etc.
- subject should concisely describe the changes
- subject can start with either lowercase or uppercase letter
- Each message should be a single line

...(中略)

Output format:
1. <commit message 1>
2. <commit message 2>
3. <commit message 3>"

大文字小文字の問題は「subject can start with either lowercase or uppercase letter」と明示することで解決しました。

fzfで全部選ぶ

言語とコードエージェントもfzfで選べるようにしています。選択肢が増えても曖昧検索できるので便利です。お好みのファジーファインダーがある方はこの辺りを変更してみてください。

# 言語選択
set -l lang (printf "ja\nen\n" | fzf --prompt="言語を選択: " --height=40% --reverse)

# コードエージェント選択
set -l code_agent (printf "claude\ncodex\ngemini\n" | fzf --prompt="コードエージェントを選択: " --height=40% --reverse)

# メッセージ選択
set -l selected (printf '%s\n' $messages | fzf --prompt="コミットメッセージを選択: " --height=40% --reverse)
fzfについて

fzfはコマンドラインのファジーファインダーです。

リストから項目を検索して選ぶのに使います。曖昧検索ができるので、適当に入力しても見つかります。

# コマンド履歴から選ぶ
history | fzf

# ファイルを選んでvimで開く
vim $(find . -type f | fzf)

エラーハンドリング

コードエージェントの呼び出しがハングしないように60秒でタイムアウトさせています。

set -l timeout_seconds 60
timeout --foreground $timeout_seconds claude --model sonnet -p <$prompt_file >$stdout_file 2>$stderr_file
set ai_status $status
set ai_stderr (cat $stderr_file)

if test $ai_status -eq 124
    echo "エラー: AI CLI ($code_agent) の呼び出しがタイムアウトしました ("$timeout_seconds"秒)"
    test -n "$ai_stderr"; and echo "$ai_stderr"
    return 1
end

コードエージェントの出力をパース

コードエージェントの出力から番号付きリストのみを抽出し、各メッセージを整形しています。(改善余地ありそう)

  1. スペース + 数字 + ピリオドのパターンを見つけて改行を挿入
  2. 行頭が「数字 + ピリオド」で始まる行だけを抽出
  3. 行頭の「数字 + ピリオド + スペース」を削除
set -l messages (echo "$ai_stdout" | sed -E 's/ ([0-9]+)\. /\n\1. /g' | grep '^\d\.' | sed -E 's/^[0-9]+\. //')

まとめ

良かった点:

  • 今のところ言語指定が確実に効く
  • 今のところ大文字小文字の変な挙動がない
  • 対話的なのが個人的に良き

微妙な点:

  • 結局ほぼClaude Codeしか使ってない
  • Geminiが遅い...(執筆時点)

参考

Discussion