README.ja.md

git-sc

AIコーディングエージェントによるスマートコミットメッセージ生成CLI

Supported Platforms

English | 日本語

---

特徴

• マルチプロバイダー対応: Antigravity CLI (agy、Gemini CLI の後継)、Codex CLI、Claude Code、opencode、Grok CLI、Apple Intelligence を自動フォールバック付きでサポート。同じプロバイダーを異なるモデル・アカウントで複数回並べられる（下記「応用: プロバイダーフォールバックチェーン」参照）
• スマートクールダウン: 失敗したステップを1時間（設定可能）優先度を下げて連続失敗を回避。provider+model+アカウント単位のキーなので、レート制限中の1アカウント/モデルが他をブロックしない
• フォーマット自動検出: 過去のコミットから形式を自動判断（Conventional、Bracket、Emoji等）
• 空リポジトリ対応: コミットがまだないリポジトリでも、Git のロケールに依存せず自動判定を安全にフォールバック
• インタラクティブ: コミット前に確認プロンプト表示（-y でスキップ可能）
• ドライラン: コミットせずにメッセージをプレビュー（-n）
• Quietモード: フック/スクリプト向けに進捗出力を抑制（-q）
• 本文サポート: 箇条書き本文付きの詳細なコミットメッセージを生成（-b）
• Amend/Squash/Reword: 既存コミットのメッセージを再生成
• 安全な一時ファイル: Unix/macOS では AI プロンプト、Codex 最終応答、reword メッセージの一時ファイルを group/other から読めない権限で作成
• エージェントコンテキスト: claw-hooks と連携し、エージェントの意図を反映したコンテキストを考慮したメッセージを生成

動作要件

• OS: macOS, Linux, Windows
• Git: 必須
• AIプロバイダー（少なくとも1つ）:
  • Antigravity CLI (agy、Gemini CLI の後継): https://antigravity.google/docs/gcli-migration を参照 (旧 Gemini CLI は 2026-06-18 で停止)
  • Codex CLI: npm install -g @openai/codex
  • Claude Code: curl -fsSL https://claude.ai/install.sh | bash
  • opencode: curl -fsSL https://opencode.ai/install | bash
  • Grok CLI (grok、xAI): cmux に同梱 (/Applications/cmux.app/Contents/Resources/bin/grok)。grok が PATH に無い場合、このステップはスキップされて次のプロバイダーへ進みます
  • Apple Intelligence: macOS版に内蔵（macOS 26+、Apple Silicon必須）

インストール

Homebrew (macOS/Linux)

brew install owayo/git-sc/git-sc

WinGet (Windows)

winget install owayo.git-sc

インストール後は新しいターミナルを開いてください。portable パッケージは PATH を書き換えるだけなので、起動中のシェルには反映されません。

ソースから

git clone https://github.com/owayo/git-smart-commit.git
cd git-smart-commit
make install

macOS の make install は一時コピーを署名してから、インストール済みバイナリをアトミックに置き換えます。再インストール時に inode 単位の古いコード署名検証キャッシュが残る問題を防ぐためです。

GitHub Releases から

Releases からお使いのプラットフォーム用のバイナリをダウンロード。

macOS (Apple Silicon)

curl -L https://github.com/owayo/git-smart-commit/releases/latest/download/git-sc-aarch64-apple-darwin.tar.gz | tar xz
sudo mv git-sc /usr/local/bin/

macOS (Intel)

curl -L https://github.com/owayo/git-smart-commit/releases/latest/download/git-sc-x86_64-apple-darwin.tar.gz | tar xz
sudo mv git-sc /usr/local/bin/

Linux (x86_64)

curl -L https://github.com/owayo/git-smart-commit/releases/latest/download/git-sc-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv git-sc /usr/local/bin/

Linux (ARM64)

curl -L https://github.com/owayo/git-smart-commit/releases/latest/download/git-sc-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv git-sc /usr/local/bin/

Windows

Releases から git-sc-x86_64-pc-windows-msvc.zip をダウンロードし、展開して PATH に追加。上記の WinGet を使えばこの手順は不要です。

クイックスタート

# ステージされた変更のコミットメッセージを生成
git-sc

# 全ステージして確認なしでコミット
git-sc -a -y

# メッセージをプレビュー（ドライラン）
git-sc -n

使い方

コマンド

コマンド	説明
git-sc	ステージされた変更のメッセージを生成
git-sc init	設定ファイルを初期化
git-sc -a	全ての変更をステージしてメッセージ生成
git-sc --amend	直前のコミットメッセージを再生成
git-sc --squash <BASE>	全コミットを1つにまとめる
git-sc --reword <HASH>	特定コミットのメッセージを再生成
git-sc -g <HASH>	既存コミットからメッセージ生成（出力のみ）

競合に対する保護:

• --reword は rebase が進行中のときは実行を拒否します。reword は失敗した rebase を必ず git rebase --abort で終わらせるため、進行中の rebase の上に重ねると解決作業中の内容を破棄してしまうためです。先に rebase を完了するか中止してください。
• メッセージ生成中にステージ内容が変化した場合、コミットを中止します（生成前後の index の tree を比較します）。生成済みメッセージは変更前の内容を説明したものなので、変更後の内容をそのままコミットするのは誤りだからです。そのまま再実行してください。--squash も reset の直前に同じ確認を行います。
• 通常のコミット、--amend、--squash は、生成中に HEAD が動いた場合も中止します。--squash がまとめる対象と --amend が書き換える対象は index ではなく履歴側にあるため、別の端末でコミットされても index はきれいなままで、ステージ変更の確認をすり抜けます。その状態で進むと、--squash は AI が見ていないコミットまで巻き込み、--amend は説明していない別のコミットを書き換えてしまいます。

オプション

基本オプション

オプション	短縮	説明
--yes	-y	確認プロンプトをスキップ
--dry-run	-n	コミットせずにメッセージを表示
--all	-a	全ての変更をステージ
--body	-b	箇条書き本文付きで生成

操作モード

オプション	短縮	説明
--amend		直前のコミットメッセージを再生成
--squash		全コミットを1つにまとめる
--reword		特定コミットのメッセージを再生成
--generate-for	-g	コミットdiffからメッセージ生成（出力のみ）

操作モード（--amend, --squash, --reword, --generate-for）は同時に指定できません。複数指定した場合は、どれか1つを暗黙に選ばず、引数パース時点でエラーになります。

--amend の注意:

• 現在の HEAD が最初のコミットでも動作します。
• 無関係な staged 変更は amend 対象のコミットに混ぜず、そのまま staged として保持します。

--reword の注意:

• 現在の HEAD 履歴に含まれるコミットのみ指定できます。
• 別ブランチなど現在の履歴外ハッシュを指定すると「無効なreword対象です」エラーで失敗します。
• 対象コミット自身が merge commit の場合も、reword 対象として拒否されます。
• 対象コミットと HEAD の間に merge commit がある場合は、「マージを跨ぐ reword は不可」という明確なエラーで拒否されます（fatal: ambiguous argument のような分かりにくい git 内部エラーにはなりません）。
• 現在の履歴で最古のコミットも reword できます（必要時は内部で git rebase -i --root を使用）。
• HEAD を reword する場合も、無関係な staged 変更は書き換え後のコミットに混ぜず、そのまま staged として保持します。
• 内部の rebase は --no-autosquash 付きで実行するため、ユーザー設定の rebase.autoSquash = true が範囲内の fixup!/squash! コミットを reword のついでに勝手に取り込むことはありません。

--squash の注意:

• 無関係な staged 変更が既にある場合、履歴を書き換える前にエラーで停止します。先に commit、unstage、または stash してください。
• squash のコミット自体が失敗した場合（pre-commit/commit-msg フックの拒否や GPG 署名エラーなど）、ブランチは merge-base に巻き戻されたまま放置されず、自動的に元の HEAD へ復旧されます。

設定

オプション	短縮	説明
--provider	-p	AIプロバイダーを指定 (antigravity, codex, claude, opencode, grok, apple-intelligence)。旧名 gemini も後方互換のため antigravity として受理
--lang	-l	コミットメッセージの言語を上書き

デバッグ・情報

オプション	短縮	説明
--quiet	-q	進捗メッセージを抑制
--debug	-d	AIに渡すプロンプトを表示
--help	-h	ヘルプを表示
--version	-V	バージョンを表示

--yes の動作:

• 無人実行では必須です。確認プロンプトで標準入力が EOF になった場合（スクリプトや hook から標準入力を閉じた状態で呼ばれた場合など）は、[Y/n] の既定値を採らずエラーで中止します。ユーザーが入力した空行は従来どおり「はい」ですが、「入力自体が無い」状態は別扱いです。同じプロンプトが --amend / --squash / --reword も守っているためです

--quiet の動作:

• 通常実行 / amend / squash / reword の進捗・プレビュー・成功/キャンセル表示を抑制
• エラー出力はそのまま表示
• --generate-for はパイプ処理向けに生成メッセージのみを標準出力に出力

--debug の動作:

• --generate-for と併用した場合、デバッグ出力（設定情報・AIプロンプト・プロバイダーコマンド・ストリーミング出力）はすべて標準エラー出力に出るため、標準出力は生成メッセージのみが保たれ、安全にパイプできます
• それ以外のモードでは、--quiet と併用した場合も含め、デバッグ出力は一体で標準出力に出ます。--quiet は進捗メッセージを抑制するだけで、デバッグ出力の出力先は変えません

使用例

# 基本的な使い方
git-sc                      # ステージされた変更のメッセージ生成
git-sc -a -y                # 全ステージして直接コミット

# プレビューと本文
git-sc -n                   # ドライラン（プレビューのみ）
git-sc -b                   # 詳細な本文付き

# Amend と Squash
git-sc --amend              # 直前のコミットメッセージを再生成
git-sc --squash origin/main # フィーチャーブランチのコミットをまとめる

# 既存コミットから生成
git-sc -g abc1234           # コミットdiffからメッセージ生成
git-sc -g abc1234 -b        # 詳細な本文付き

設定

初期設定

git-sc init で設定ファイルを初期化するか、~/.config/git-sc/config.toml を手動で作成します:

git-sc init

これにより ~/.config/git-sc/config.toml にデフォルト設定の設定ファイルが作成されます。

既存の設定を上書きするには --force を使用します:

git-sc init --force

階層的設定

git-sc はプロジェクトレベルでの上書きが可能な階層的設定をサポートしています:

ファイル	スコープ	説明
~/.config/git-sc/config.toml	グローバル	ユーザー全体のデフォルト設定
.git-sc	プロジェクト	リポジトリ固有の上書き設定（リポジトリルートに配置）

プロジェクト設定はグローバル設定を上書きします。プロジェクト設定で指定されていないフィールドはグローバル設定から継承されます。上書きしたいフィールドのみ指定できます — [models] セクションの部分指定もサポートしています。

設定例

# AIプロバイダーの優先順位
# "antigravity" は旧 Gemini CLI の後継 (`agy`)。"gemini" と書いても後方互換のため同じプロバイダーとして扱う
providers = ["opencode", "grok", "antigravity", "codex", "claude", "apple-intelligence"]

# コミットメッセージの言語
language = "Japanese"

# コミットプレフィックス形式（オプション）
# 値: conventional, bracket, colon, emoji, plain, none
prefix_type = "conventional"

# コミット後に自動プッシュ（オプション）
auto_push = true

# Codex 呼び出し時に `-c model_reasoning_effort=<値>` として渡す推論深度
# 値: "low"（デフォルト）/ "medium" / "high" / "xhigh" / "" (codex 既定動作を使う場合は空文字列)
codex_reasoning_effort = "low"

# モデル設定
# Antigravity CLI (`agy`) は `--model` に対応。`antigravity` の値はそのまま
# `agy --model "<名前>"` に渡されます。表示名 (例: "GPT-OSS 120B (Medium)"、
# "Gemini 3.5 Flash (Low)") と slug (例: "gpt-oss-120b-medium"、
# "gemini-3.5-flash-low") のどちらでも指定できます。`agy models` がどちらを表示するかは
# agy のバージョンで変わります (1.0.x は表示名、1.1.10 は slug)。未知の名前は
# 非ゼロ終了で明示的に弾かれ、既定モデルへ黙って落ちることはないため、
# 打ち間違いはそのステップの失敗として現れます。
# 空文字列なら `--model` を省略し agy 自身の既定モデルに委ねます。
# 旧 `gemini = "..."` キーは後方互換の入力エイリアスとして受理され、`antigravity` に
# 昇格します(両方指定した場合は `antigravity` が優先)。
# Grok CLI は `-m` に対応。`grok models` が返す ID (例: "grok-4.5") をそのまま指定します。
# 空文字列なら `-m` を省略し grok 自身の既定モデルに委ねます。
[models]
antigravity = "GPT-OSS 120B (Medium)"
codex = "gpt-5.6-luna"
claude = "haiku"
opencode = ""
grok = ""

# プロバイダークールダウン（分）
provider_cooldown_minutes = 60

# プロバイダータイムアウト（秒）
provider_timeout_seconds = 60

設定オプション

オプション	説明	デフォルト
providers	プロバイダーのフォールバックチェーン。各要素はプロバイダー名の文字列、または {provider, model, command, env, name} テーブル（下記「応用: プロバイダーフォールバックチェーン」参照。antigravity を推奨、gemini も後方互換で受理）	["opencode", "antigravity", "codex", "claude", "apple-intelligence"]
language	コミットメッセージの言語	"Japanese"
prefix_type	コミットプレフィックス形式	自動検出
auto_push	コミット後に自動プッシュ	false
codex_reasoning_effort	Codex の -c model_reasoning_effort に渡す値（low, medium, high, xhigh, 空文字列で省略）	"low"
models.*	各プロバイダーのモデル	設定参照
provider_cooldown_minutes	失敗プロバイダーのクールダウン。極端に大きい値は実質無期限として扱う	60
provider_timeout_seconds	プロバイダー呼び出しのタイムアウト	60
prefix_rules	URLベースのプレフィックス形式	[]
prefix_scripts	外部プレフィックススクリプト	[]
ai_usage	ai-usage CLI による残量ゲート（「残量ゲート」を参照）	無効
dev_log	開発者向け生成ログ（グローバル設定のみ。「開発者向け生成ログ」を参照）	無効

既存のグローバル設定ファイルは自動では書き換えられません。現在の Codex 既定モデルは gpt-5.6-luna です。既存設定で使うには、~/.config/git-sc/config.toml の models.codex を更新してください。Codex CLI を更新したら必ず確認してください。 以前の既定値 gpt-5.6-luna は Codex から削除済みで、削除されたモデル名を指定してもフォールバックは起きません。HTTP 400 が返り、git-sc はこれをプロバイダーの失敗として扱ってクールダウンに入れるため、古い models.codex が残っていると毎回 Codex がフォールバックチェーンから静かに外れます。この既定値は、API で利用可能・一覧表示対象・medium reasoning 対応の Codex モデルについて input_tokens を比較し、2026年9月17日 (JST) に再選定したものです。計測は空ディレクトリで Reply ok. を使い、--ignore-user-config --ignore-rules --ephemeral --sandbox read-only と model_reasoning_effort='medium' を指定しました: gpt-5.6-luna = 19609、gpt-5.5 = 20181、gpt-5.6-sol = 21174、gpt-5.6-terra = 21174、gpt-6-astra = 22035。いずれの試行も最終出力が ok でツール呼び出しはなく、2 回目の計測でも全モデルが同一値を再現しました。

Antigravity (agy) の既定モデルは GPT-OSS 120B (Medium) で、実測に基づいて選定しています。agy 1.1.10 で print mode に --output-format json が追加され、1リクエストごとの usage が取得できるようになったため、Codex と同じ input_tokens 比較が可能になりました (それ以前の agy には機械可読な使用量出力がなく、この既定値は公開価格を根拠にしていました)。2026年8月4日 (JST) に agy 1.1.10 で、空ディレクトリ・固定プロンプト Reply ok. で実測した結果: gpt-oss-120b-medium = 13680、gemini-3.5-flash-medium = 16994、gemini-3.5-flash-low = 16998、gemini-3.1-pro-low = 17684、gemini-3.6-flash-low = 18175、gemini-3.6-flash-medium = 18176、claude-sonnet-4-6 = 19346。いずれも1ターンで成功し、gpt-oss-120b-medium が約19%差で最小だったため既定値を維持します。これは1リクエストあたりの最小オーバーヘッドの比較であり、実作業での品質を保証するものではありません。既存設定で使うには ~/.config/git-sc/config.toml の models.antigravity を追加・更新するか、"" を指定して agy 自身の既定に委ねてください。

プロバイダーのクールダウン状態は、並び替え前に旧エイリアスを正規化します。そのため gemini/agy のクールダウンは antigravity に、旧 apple-ai / apple_intelligence キーは apple-intelligence に引き続き適用されます。--debug 付きで実行すると、設定の providers に旧 gemini エイリアスが残っている場合に「antigravity に正規化される」旨の注意が一度だけ表示されます。

応用: プロバイダーフォールバックチェーン（モデル / アカウント / コマンド）

providers の各要素は、プロバイダー名のみの文字列に加えて、model / command / env を持つテーブルでも書けます。これにより、同じプロバイダーを異なるモデルやアカウントで複数回並べたフォールバックチェーンを構築できます。1つのプロバイダーがモデル系統ごと・アカウント/契約ごとにクォータを分けている場合に有用です。

providers = [
  # 同じプロバイダー・別アカウント(env で CODEX_HOME / CLAUDE_CONFIG_DIR を切替)
  { provider = "codex", model = "gpt-5.6-luna", env = { CODEX_HOME = "~/.codex" } },       # アカウント1
  { provider = "codex", model = "gpt-5.6-luna", env = { CODEX_HOME = "~/.codex-work" } },  # アカウント2
  # 同じプロバイダー・別モデル系統(クォータが別)
  { provider = "antigravity", model = "Gemini 3.5 Flash (Low)" },
  { provider = "antigravity", model = "GPT-OSS 120B (Medium)" },
  # 従来どおり文字列(プロバイダー名のみ)も使えます
  "claude",
]

ステップごとのフィールド:

フィールド	説明
provider	必須。CLI の引数規約を決めるプロバイダー種別(codex/antigravity/claude/opencode/apple-intelligence、gemini/agy はエイリアス)。
model	任意。このステップのモデル。省略時は [models].<provider>、さらに各 CLI 既定にフォールバック。
command	任意。provider 既定バイナリの代わりに実行するバイナリ(と固定引数)。ラッパースクリプト等。~ は展開される。codex の --disable hooks 等の標準引数は引き続き付与される。
env	任意。このステップ起動時に Command::env() で明示的に設定する環境変数。値の ~ は展開され、キーは POSIX 名である必要がある。動的ローダー / インタプリタの事前ロード系キー (LD_PRELOAD, DYLD_INSERT_LIBRARIES, NODE_OPTIONS, PYTHONPATH 等) は、project 側 .git-sc 経由のコード注入を防ぐため大小文字を区別せず設定エラーとして拒否されます。
name	任意。クールダウンキーとログ表示に使う識別子。省略時は provider + model + env + command から決定的に導出。

アカウント切替(推奨: env)。 Codex と Claude Code は CODEX_HOME / CLAUDE_CONFIG_DIR からアカウント/認証を選びます。これらをステップごとに env で設定すると、それぞれ別クォータのアカウントをまたいでフォールバックできます。git-sc は Command::env() で明示的に上書きするため、git-sc を起動したシェルに CODEX_HOME / CLAUDE_CONFIG_DIR が export されていても、起動される CLI はその影響を受けません。(command でラッパースクリプトを使う方法もありますが、env の方が明示的で --debug にも表示されるため推奨です。)

独立したクールダウン。 クールダウンキーは provider + model + env(+ command、または明示 name)を含むため、各ステップは独立して降格されます。codex のアカウント1がレート制限に達しても、codex のアカウント2や、別モデルの antigravity は引き続き使えます。

prefix_type の値

値	例	説明
conventional	feat: add feature	Conventional Commits 形式
bracket	[feat] add feature	ブラケット形式
colon	feat: add feature	シンプルなコロン形式
emoji	:sparkles: add feature	絵文字形式
plain	Add feature	プレフィックスなし
none	add feature	プレフィックスなし、小文字

プレフィックスルール

リモートURLでコミット形式を指定:

[[prefix_rules]]
url_pattern = "github\\.com[:/]myorg/"
prefix_type = "conventional"  # conventional, bracket, colon, emoji, plain, none

一致したルールの prefix_type は上記の有効値である必要があります。無効な一致ルールは警告を出してスキップされるため、後続のプレフィックスルール、設定済みの prefix_type、または自動判定にフォールバックできます。

プレフィックススクリプト

外部スクリプトでカスタムプレフィックスを生成:

[[prefix_scripts]]
url_pattern = "^https://gitlab\\.example\\.com/"
script = "/path/to/prefix-generate.py"

プレフィックススクリプトが有効な prefix_type 名（conventional, bracket, emoji 等）を返した場合、リテラルなプレフィックス文字列ではなくルールモードとして解釈されます。これにより、ブランチ名やリモートURLに応じてコミットフォーマットを動的に切り替えることができます。

リテラルなプレフィックス文字列では、echo など一般的なスクリプト出力に含まれる末尾改行（\n/\r\n）だけを除去します。プレフィックスとして意図した末尾スペースは保持されます。

プレフィックススクリプトが空文字を返した場合（exit 0 かつ標準出力なし）、git-sc は生成メッセージをそのまま使います。ただし先頭が Conventional Commits の type プレフィックス（例: feat:, fix(scope):, feat!:）の場合のみ、そのプレフィックスを除去します。

プレフィックススクリプトが終了コード 1 で終了した場合、git-sc はプレフィックスを追加せず AI 生成メッセージをそのまま使います。それ以外の非 0 終了コードはスクリプト実行失敗として扱い、次に一致するプレフィックススクリプト、プレフィックスルール、設定済みの prefix_type、または自動判定へフォールバックします。

プロジェクトレベルの .git-sc では、相対 script パスは Git リポジトリのルートから解決され、スクリプトの作業ディレクトリも Git ルートになります。

#!/bin/bash
# 例: "conventional" を返すと Conventional Commits 形式が適用される
echo "conventional"

差分の処理

• 空白のみの変更は除外
• バイナリファイルは除外
• スペースや非 ASCII 文字を含むパスの引用付き diff ヘッダーも正しく解析
• .git-sc-ignore パターンを適用
• 10,000文字で切り詰め

セキュリティメモ

• AI プロンプトには staged diff の内容が含まれる場合があります。opencode などのプロバイダー向けに一時プロンプトファイルが必要な場合や Codex の最終応答ファイルを使う場合、Unix/macOS では group/other 権限を付けずに作成し、使用後に自動削除します。
• reword 用コミットメッセージの一時ファイルも同じ権限で作成します。
• プロバイダーのクールダウン状態ファイル (~/.config/git-sc/.providers-state) も group/other 権限を付けずに作成します。クールダウンキーには各ステップの env の値がそのまま含まれるためです。
• .git-sc-ignore の読み込みに失敗した場合は処理を中止します。 ファイルが存在するのに読めない・解釈できない場合、除外なしで続行せずエラーで終了します。そのまま続行すると、除外したかったファイルが黙って AI プロバイダーへ送られてしまうためです。
• .git-sc-ignore は diff の表示形式に関する Git 設定の影響を受けません。 除外判定は diff --git a/… b/… 行からファイルパスを読んで行うため、この行の形を変える設定 (diff.noprefix / diff.mnemonicPrefix / diff.srcPrefix / diff.dstPrefix / color.ui = always / diff.external) があると、パターンが黙って一切マッチしなくなります。git-sc は diff 取得時にプレフィックス・色・パスの基準を固定して要求するので、これらの設定に関係なく同じようにパターンが適用されます。diff.relative も同様です。この設定は加えて「git-sc を実行したディレクトリの外にある変更を diff から隠す」効果を持ちますが、基準を固定しているため、どのサブディレクトリで実行してもステージ済みの差分全体からメッセージが書かれます。
• プロジェクトの .git-sc はコードを実行できます。 providers[].command、prefix_scripts[].script、ai_usage.command は git-sc が起動する実行ファイルを指定するもので、リポジトリ内の .git-sc は他の設定と同様にマージされます。信頼できないリポジトリを clone してその中で git-sc を実行すると (エージェントの stop hook 経由の自動実行を含む)、これらが指す実行ファイルが動きます。env のキーは検証され動的ローダー/インタープリタの事前ロード系は拒否されますが、この 3 つのフィールドはその対象外です。Makefile や git hook と同じように、実行前にそのリポジトリの .git-sc を確認してください。

.git-sc-ignore

Git が日本語ファイル名などを quoted path としてエスケープしていても、復元後の実パスに対してパターン照合します。 rename diff では変更前と変更後の両パスを対象に照合するため、無視対象ディレクトリへの移動も一貫して除外されます。 ファイル名にスペースが含まれている場合も対応しています。Git はスペースだけを含むファイル名をクォートせずに diff --git ヘッダーへ出力しますが、git-sc は正しいパスを抽出するため、無視パターンが一貫して適用されます。 変更前後のパスが異なり、両方にスペースを含む rename ヘッダーも同じように処理します。片側だけがクォートされる混在ヘッダー（例: old name.txt を Git がクォートする非 ASCII ファイル名へ rename した場合）も両方向に対応しています。

package-lock.json
yarn.lock
Cargo.lock
*.generated.ts

自動プッシュ

設定ファイルで自動プッシュを有効にできます:

# ~/.config/git-sc/config.toml または .git-sc に記述
auto_push = true

有効にすると、git-sc はコミットまたは squash 成功後に git push を実行します。

残量ゲート (ai-usage 連携)

ai-usage CLI がインストールされている場合、残量が尽きかけているアカウントのプロバイダーを、呼び出す前にフォールバックチェーンから外せます。既定では無効です。

[ai_usage]
enabled = true
command = ["ai-usage", "--json"]  # 省略可（実行ファイルのパスの `~` は展開されます）
threshold_percent = 95            # この使用率以上のステップを除外する
window = "nearest"                # weekly / five_hour / nearest (両者のうち高い方)
timeout_seconds = 10

git-sc は起動時にこのコマンドを 1 回だけ実行し、フォールバックチェーンの各ステップを対応するアカウントの使用率と照合します。threshold_percent 以上のステップは その実行に限り チェーンから外れます (プロバイダーのクールダウン状態には影響しません)。

各ステップがどのアカウントに属するかは、次のフィールドで指定できます。

[[providers]]
provider = "codex"
ai_usage_profile = "Work"          # ai-usage の `profile` と完全一致 (大文字小文字を区別)
env = { CODEX_HOME = "~/.codex-work" }

[[providers]]
provider = "antigravity"
ai_usage_group = "Claude&GPT"      # `group_label` と一致 (大文字小文字を区別しない)

ai_usage_group があるのは、1 つのアカウントの枠がモデル系統ごとに分かれている場合があるためです。Antigravity は Gemini と Claude&GPT という別々の枠を報告し、それぞれ独立に消費されます。ai_usage_profile を指定しない場合、git-sc はそのプロバイダーで最も使用率の低いアカウントを基準に判定します。ただしこれは 判定にしか影響しません。ステップが実際にどのアカウントで動くかは env が決めるため、判定と実行を一致させたい場合は両方を指定してください。

失敗時の扱いは意図的に非対称です。コマンドを実行できない・タイムアウトする・出力を解釈できない場合は、チェーンをそのままにしてコミットを続行します (補助ツールの不調でコミットを止めてはならないため)。一方、使用率の取得に成功したうえで すべてのステップ が閾値超過だった場合は、既定のチェーンへフォールバックせずエラーで停止します。フォールバックすると、ゲートが今しがた除外したプロバイダーをそのまま呼ぶことになるためです。

プロジェクトの .git-sc からはフィールド単位で上書きできます。書かなかったフィールドはグローバル設定の値がそのまま残ります。

開発者向け生成ログ

どのプロンプトを渡して何が返ってきたかを記録します。プロンプトを変更したときの効果を、印象ではなく実データで比較するためのものです。既定では無効です。

# ~/.config/git-sc/config.toml のみ有効（プロジェクトの .git-sc からは有効化できません）
[dev_log]
enabled = true
content = "metadata"   # metadata | full
retention_days = 14
max_total_mb = 500

1 回の実行につき 1 つの JSON ファイルを ~/.config/git-sc/logs/YYYY-MM-DD/ に書き出します。内容はプロンプトのハッシュと差分の統計、各プロバイダーの試行（整形前の生応答・モデル・所要時間・品質判定・採用/引き直し/フォールバックの別）、そして実行の結末（コミットした場合はそのハッシュを含む）です。一時ファイルに書き切ってから rename して公開するため、git-sc を同時に走らせても行が混ざらず、書きかけのファイルが完成品として解析対象に混ざることもありません。

解析はファイル群をそのまま JSONL に流し込めます:

find ~/.config/git-sc/logs -name '*.json' | sort | xargs jq -c .

# 例: プロバイダーごとに壊れた件名が出た回数を数える
find ~/.config/git-sc/logs -name '*.json' | xargs jq -r \
  '.attempts[] | select(.findings | length > 0) | "\(.provider)\t\(.findings[0])"' | sort | uniq -c

取り扱いの注意。 既定の content = "metadata" はプロンプトの統計とハッシュだけを残し、本文は残しません。プロバイダーの stderr も落とします — Codex はそこにプロンプトをエコーするため、残すと別経路で差分がログに入ってしまうためです。content = "full" は実際に送ったプロンプトをそのまま保存するので、ステージ済みの差分が平文でディスクに残ります。プロバイダーの生応答はどちらの詳細度でも残します。整形後のメッセージだけでは生成事故を追えないためです。環境変数の上書きは名前だけを記録し、値は残しません。ログは 0700 のディレクトリ内に 0600 で作成し、retention_days を過ぎたものと max_total_mb を超えた分（古い順）を削除します。この掃除は 1 日 1 回までです。書き込みに失敗した場合は警告を 1 行出すだけで（--quiet では出しません）、コミットはそのまま続行します。

グローバル設定専用にしているのは意図的です。clone したリポジトリの .git-sc がログ出力を有効にしたり、自分のコードの書き出し先を選べたりしてはいけないためです。プロジェクト側の [dev_log] は警告を出して無視します。

VS Code 拡張機能

Git-SC (Smart Commit) - VS Code マーケットプレイスで公開中

Claude Code との連携

~/.claude/settings.json に追加:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "git-sc --all --yes --quiet"
          }
        ]
      }
    ]
  }
}

エージェントコンテキスト（claw-hooks 連携）

git-sc を claw-hooks と併用すると、コーディングエージェントが何を行っていたかのコンテキストが CLAW_HOOKS_AGENT_MESSAGE 環境変数経由で自動的に渡されます。このコンテキストはAIプロンプトに含まれ、生の差分の説明ではなく、変更の意図を反映したコミットメッセージの生成を可能にします。

claw-hooks は Claude Code のフックライフサイクルを管理するコンパニオンツールです。stop hook が発火する際、エージェントの最後のアクティビティサマリーを CLAW_HOOKS_AGENT_MESSAGE にセットしてから git-sc を呼び出します。

# claw-hooks の stop hook が自動的にセットします
# CLAW_HOOKS_AGENT_MESSAGE="認証モジュールをJWTトークン方式にリファクタリング"
git-sc -a -y -q

環境変数がセットされている場合、プロンプトに「Agent Context」セクションが追加され、AIが開発者の意図を優先するようガイドされます。 これは通常のコミット生成に加えて、--amend、--reword、--squash、--generate-for でも適用されます。

動作の仕組み

flowchart LR
    A[変更をステージ] --> B[差分取得]
    B --> C[フォーマット検出]
    C --> D[AIで生成]
    D --> E[確認してコミット]

Loading

1. 環境確認: gitリポジトリとAIエージェントの利用可否を確認
2. 設定読み込み: ~/.config/git-sc/config.toml から設定を読み込み
3. 差分取得: ステージされた変更を取得（除外設定適用）
4. フォーマット検出: 過去のコミットまたはルールから検出
5. 生成: AIに送信（フォールバック付き）
6. コミット: 確認してコミットを作成

Grok CLI

Grok プロバイダーは Grok Build TUI (grok、xAI) を利用します。この CLI は plan モード・セッションをまたぐ memory・web 検索・ツール実行が既定で有効なコーディングエージェントであるため、git-sc は 1 ターンの純粋関数として振る舞うように制約をかけて起動します。

フラグ	目的
--output-format plain	対話 TUI ではなく headless のテキスト出力にする
--sandbox read-only	Codex のサンドボックスと同様にファイル書き込みとネットワークを禁止する
--no-plan / --no-memory	plan モードとセッションをまたぐ memory を無効化する（どちらも既定で有効）
--disable-web-search	web fetch / 検索を無効化する
--max-turns 1	ツールのループを 1 ターンで打ち切る
--verbatim	CLI 側でプロンプトを書き換えさせない
--prompt-file <一時ファイル>	大きな diff で ARG_MAX や cmd.exe のメタ文字問題を避ける

• モデル: ステップの model > [models].grok > 空（grok 自身の既定に委ねる）の順で解決します。非空の場合は grok models が返す ID（現在は grok-4.5 のみ）を -m "<id>" として渡します。同梱の既定値は空にしてあり、将来より安価なモデルが追加されても git-sc のリリースなしで追随できます。
• 入手: Grok CLI は cmux に同梱されています (/Applications/cmux.app/Contents/Resources/bin/grok)。grok が PATH に無い場合、このステップはスキップされて次のプロバイダーへ進みます。

Apple Intelligence

Apple Intelligence プロバイダーは、fm-rs（Appleの Foundation Models フレームワークのRustバインディング）を使用し、完全オンデバイス推論を行います。APIキーやネットワーク接続は不要です。

• 動作要件: macOS 26（Tahoe）以降、Apple Silicon、システム設定でApple Intelligenceが有効であること
• 仕組み: Apple Intelligence を有効化した状態で実行すると（macOSではデフォルト）、git-scがfm-rs経由でFoundation Modelsを直接呼び出します。コミットメッセージ生成用のinstructionsを設定した LanguageModelSession を毎回作成します。instructionsは解決済みのプレフィックス種別から構築されるため、prefix_type = "none" / "bracket" / "emoji" や直近コミットからの自動判定が尊重されます（常に Conventional Commits を強制することはありません）
• コンテキスト長: オンデバイスモデルのコンテキストは 4096 トークンで、他のプロバイダーより桁違いに小さいです。git-sc は生成前にプロンプトのトークン数を計測し、収まらない場合は変更ファイル一覧を残したまま diff 本文を縮約してプロンプトを組み直します。この場合はメッセージが変更の一部だけを見て書かれることになるため、警告を表示します。縮約しても収まらないときは、コミットを失敗させずに次のプロバイダーへ進みます。
• タイムアウト: provider_timeout_seconds（既定 60 秒）が適用されます。CLI プロバイダーと同じ設定です。
• 失敗の扱い: プロンプト起因の失敗（コンテキスト長超過・安全ガードレール・拒否・非対応言語）はクールダウンに入れません。クールダウンに入るのは、モデルが現在使えないことを示す失敗（アセット未取得・レート制限・タイムアウト）だけです。この失敗種別の判定には macOS 27 SDK 以降でのビルドが必要で、macOS 26 ではすべてプロバイダー側の失敗として扱われます。
• ビルド: cargo build --features apple-ai（macOSでは make build / make install で自動的に有効）。macOS 27 以降でビルドすると Foundation Models 27 の機能（正確なトークン数計測・型付きエラー・応答ごとのトークン使用量）も有効になります。macOS 26 も引き続きサポートします。
• クロスプラットフォーム: Linux/WindowsではApple Intelligenceは利用できず、自動的にスキップされます

プラットフォームの注意

• Windows: Antigravity CLI (agy) プロバイダーは明示エラーでスキップされます。Windows では全プロバイダーを cmd /C 経由で起動します（npm でインストールされる .cmd シム対応のため）が、cmd.exe は複数行の diff を含むプロンプトをコマンドライン引数として安全に受け取れず、渡すとコマンドラインが破損します（CVE-2024-24576 と同クラスのコマンドインジェクション経路でもあります）。フォールバックチェーンは次のプロバイダーへ進みます。プロンプトを stdin や一時ファイルで受け取るプロバイダー（codex、claude、opencode、grok）は影響を受けません。

ビルドコマンド

コマンド	説明
make build	デバッグビルド
make release	リリースビルド
make install	ビルドして /usr/local/bin にインストール
make test	テスト実行
make fmt	コードフォーマット
make check	clippy と cargo check を実行（macOS では apple-ai を含む）
make clean	ビルド成果物をクリーン

コントリビュート

コントリビュートを歓迎します！お気軽にプルリクエストをお送りください。

変更履歴

バージョン履歴は Releases を参照してください。

ライセンス

MIT