🐟
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
これだけです。あとは対話的に選んでいくだけ。
- 言語選択(日本語 or 英語)
- コードエージェント選択(Claude Code / Codex / Gemini)
- 生成された3つのメッセージから1つ選ぶ
- 自動でコミット完了
実装の要点
全体で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
コードエージェントの出力をパース
コードエージェントの出力から番号付きリストのみを抽出し、各メッセージを整形しています。(改善余地ありそう)
- スペース + 数字 + ピリオドのパターンを見つけて改行を挿入
- 行頭が「数字 + ピリオド」で始まる行だけを抽出
- 行頭の「数字 + ピリオド + スペース」を削除
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