クイックスタート

uvx gac init   # プロバイダー、モデル、言語を設定
uvx gac  # LLMで生成してコミット

これだけです！生成されたメッセージを確認して y で確定します。

---

主な機能

33+ 対応プロバイダ

• Anthropic • Azure OpenAI • Cerebras • ChatGPT (OAuth) • Chutes.ai • Claude Code (OAuth)
• Crof.ai • DeepInfra • DeepSeek • Fireworks • Gemini • GitHub Copilot (OAuth) • Groq
• Kimi for Coding • Lilac • LM Studio • MiniMax.io • Mistral AI • Moonshot AI • Neuralwatt • Ollama
• Ollama Cloud • OpenAI • OpenCode Go • OpenRouter • Plexus Gateway • Qwen Cloud (CN & INTL)
• Replicate • Streamlake/Vanchin • Synthetic.new • Together AI • Wafer.ai • Z.AI (API & Coding Plans)
• Custom Endpoints (Anthropic/OpenAI)

🧠 スマートな LLM 分析

• 意図を理解: コード構造、ロジック、パターンを分析して、変更点だけでなく「なぜ」変更したのかを理解
• 意味論的な認識: リファクタリング、バグ修正、機能追加、破壊的変更を認識して文脈に応じた適切なメッセージを生成
• インテリジェントなフィルタリング: 生成されたファイル、依存関係、アーティファクトを無視しながら意味のある変更を優先
• インテリジェントなコミットグループ化 - --group で関連する変更を複数の論理的なコミットに自動的にグループ化

📝 複数のメッセージ形式

• ワンライナー (-o フラグ): 従来のコミット形式に従う単一行のコミットメッセージ
• 標準 (デフォルト): 実装の詳細を説明する箇条書き付きの要約
• 詳細 (-v フラグ): 動機、技術的アプローチ、影響分析を含む包括的な説明
• 50/72 ルール (--50-72 フラグ): git log と GitHub UI での最適な可読性のため、クラシックなコミットメッセージ形式を強制
• DCO/Signoff (--signoff フラグ): Developer Certificate of Origin コンプライアンスのための Signed-off-by 行を追加（Cherry Studio、Linux カーネル、その他のプロジェクトで必要）

🌍 多言語サポート

• 25+ 言語: 英語、中国語、日本語、韓国語、スペイン語、フランス語、ドイツ語など 18+ の言語でコミットメッセージを生成
• 柔軟な翻訳: ツール互換性のために従来のコミットプレフィックスを英語のままにするか、完全に翻訳するかを選択
• 複数のワークフロー: uvx gac language でデフォルト言語を設定するか、-l <language> フラグで一回限り上書き
• ネイティブスクリプトサポート: CJK、キリル文字、タイ文字など非ラテン文字も完全サポート

💻 開発者体験

• 対話型フィードバック: r で再生成、e で編集（デフォルトはインプレース TUI、または $GAC_EDITOR が設定されている場合はそちら）、または「もっと短くして」「バグ修正に集中」のようなフィードバックを直接入力
• 対話型質問: --interactive (-i) を使用して変更に関する質問に答え、より文脈に合ったコミットメッセージを取得
• ワンコマンドワークフロー: uvx gac -ayp のようなフラグで完全なワークフロー（すべてステージ、自動確定、プッシュ）
• Git 統合: 高価な LLM 操作の前に pre-commit と lefthook フックを実行して尊重
• MCP サーバー: uvx gac serve を実行して Model Context Protocol 経由で AI エージェントにコミットツールを公開

📊 使用統計

uvx gac stats               # 概要：合計 gac 数、ストリーク、毎日/毎週のピーク、トッププロジェクトとモデル
uvx gac stats models        # モデル別内訳：gac 数、トークン、レイテンシ、速度、コミット別レイテンシチャート
uvx gac stats projects      # プロジェクト別内訳：全リポジトリの gac 数、コミット数、トークン数、gac あたり平均ファイル数
uvx gac stats recent        # 最近の gac 履歴：gac あたりのトークン、速度、レイテンシ、ファイル数（-n 20 で更多）
uvx gac stats reset         # 全統計をリセット（確認あり）
uvx gac stats reset model <model-id>  # 特定モデルの統計のみリセット

• gac の使用を追跡: gac で何回コミットしたか、現在のストリーク、1日/1週間のアクティビティのピーク、トッププロジェクトを確認
• トークントラッキング: 日、週、プロジェクト、モデルごとのプロンプト + 完了トークン合計 — トークン使用量のハイスコアトロフィー付き
• トップモデル: 最も使用しているモデルと各モデルのトークン消費量を確認
• ハイスコアのお祝い: 🏆 新しい日次、週次、トークン、またはストリーク記録を樹立したときにトロフィーを獲得；🥈 記録に並んだときに獲得
• セットアップ時のオプトイン: uvx gac init が統計を有効にするかどうかを確認し、保存される内容を説明します
• いつでもオプトアウト: GAC_DISABLE_STATS=true（または 1/yes/on）を設定して無効化。false/0/no に設定（または未設定）すると統計は有効のまま
• プライバシー優先: ~/.gac_stats.json にローカル保存。カウント、日付、プロジェクト名、モデル名のみ — コミットメッセージ、コード、個人情報は一切保存しません。テレメトリなし

🛡️ 組み込みセキュリティ

• 自動秘密検出: コミット前に API キー、パスワード、トークンをスキャン
• 対話型保護: 機密性の高いデータをコミットする前にプロンプトと明確な修復オプションを表示
• スマートフィルタリング: 偽陽性を減らすためにサンプルファイル、テンプレートファイル、プレースホルダーテキストを無視

---

使用例

基本ワークフロー

# 変更をステージ
git add .

# LLMで生成してコミット
uvx gac

# 確認 → y (コミット) | n (キャンセル) | r (再生成) | e (編集) | またはフィードバックを入力

一般的なコマンド

コマンド	説明
uvx gac	コミットメッセージを生成
uvx gac -y	自動確定（確認不要）
uvx gac -a	コミットメッセージ生成前にすべての変更をステージ
uvx gac -S	インタラクティブにステージするファイルを選択
uvx gac -o	些細な変更のための単一行メッセージ
uvx gac -v	動機、技術的アプローチ、影響分析を含む詳細形式
uvx gac -h "ヒント"	LLM へのコンテキストを追加（例: uvx gac -h "バグ修正"）
uvx gac -s	スコープを含める（例: feat(auth):）
uvx gac -i	変更について質問してより良いコンテキストを取得
uvx gac -g	変更を複数の論理的なコミットにグループ化
uvx gac -p	コミットしてプッシュ
uvx gac model	AIプロバイダーとモデルを変更
uvx gac stats	gac の使用統計を表示

パワーユーザー例

# 一コマンドで完全なワークフロー
# コミット統計を表示
uvx gac stats

# すべてのプロジェクトの統計
uvx gac stats projects

uvx gac -ayp -h "リリース準備"

# スコープ付きの詳細な説明
uvx gac -v -s

# 小さな変更のためのクイックワンライナー
uvx gac -o

# 特定の言語でコミットメッセージを生成
uvx gac -l ja

# 変更を論理的に関連するコミットにグループ化
uvx gac -ag

# 詳細な出力で対話モードを使用した詳細な説明
uvx gac -iv

# LLMが見ているものをデバッグ
uvx gac --show-prompt

# セキュリティスキャンをスキップ（注意して使用）
uvx gac --skip-secret-scan

# DCO コンプライアンスのための signoff を追加（Cherry Studio、Linux カーネルなど）
uvx gac --signoff

対話型フィードバックシステム

結果に満足できないですか？いくつかのオプションがあります：

# シンプルな再生成（フィードバックなし）
r

# コミットメッセージを編集
e

# またはフィードバックを直接入力！
もっと短くして、パフォーマンス改善に集中
スコープ付きで従来のコミット形式を使用
セキュリティへの影響を説明

# 空入力でEnterを押すとプロンプトを再表示

編集機能（e）でコミットメッセージを洗練できます：

• デフォルト（インプレース TUI）: vi/emacs キーバインドでの複数行編集 — タイポ修正、表現調整、再構成
• GAC_EDITOR 使用時: お好みのエディタ（code、vim、nano など）を開く — 検索/置換、マクロなど、エディタの全機能を利用可能

VS Code のような GUI エディタは自動的に処理されます：gac が --wait を挿入し、エディタのタブを閉じるまでプロセスがブロックされます。追加の設定は不要です。

---

設定

uvx gac init を実行して対話的にプロバイダーを設定するか、環境変数を設定：

後からプロバイダーやモデルを変更したいが言語設定は触りたくない場合？uvx gac model を使用して言語プロンプトをスキップしたストリームラインなフローを実行します。

利用可能なすべてのオプションについては .gac.env.example を参照。

別の言語でコミットメッセージが必要ですか？ `uvx gac language を実行して、Español、Français、日本語など 25+ の言語から選択してください。

コミットメッセージスタイルをカスタマイズしたいですか？ カスタムシステムプロンプトの作成ガイドについては docs/CUSTOM_SYSTEM_PROMPTS.md を参照。

---

ヘルプ

• 完全なドキュメント: USAGE.md - 完全な CLI リファレンス
• MCP サーバー: MCP.md - GAC を AI エージェント用の MCP サーバーとして使用
• Claude Code OAuth: docs/CLAUDE_CODE.md - Claude Code のセットアップと認証
• ChatGPT OAuth: docs/CHATGPT_OAUTH.md - ChatGPT OAuth のセットアップと認証
• カスタムプロンプト: CUSTOM_SYSTEM_PROMPTS.md - コミットメッセージスタイルのカスタマイズ
• 使用統計: uvx gac stats --help または完全なドキュメントを参照
• トラブルシューティング: TROUBLESHOOTING.md - 一般的な問題と解決策
• 貢献: CONTRIBUTING.md - 開発設定とガイドライン

---