google-gemini/gemini-cli

Gemini CLI – AI 搭載コマンドラインアシスタント

概要 – Google がメンテナンスするオープンソースのコマンドラインツールで、ターミナルから直接 Gemini ファミリーの大規模言語モデルと対話できます。コードの読み取り、編集、生成、シェルコマンドの実行、Web データの取得、Google の Vertex AI やその他のサービスとの統合が可能な AI エージェントとして機能します。

主な機能

• コードの理解と生成 – Gemini のマルチモーダルモデルを使用して、変更の要約、デバッグ、またはアプリケーション全体の作成（PDF、画像、スケッチからでも）が可能です。
• 自動化 – プルリクエストの照会、リベースの実行、スクリプトの実行、またはメディア生成、Slack メッセージ、データベースクエリなどのためのカスタム MCP（モデル接続プログラム）サーバーの呼び出しが可能です。
• 柔軟な認証 – Google OAuth、Gemini API キー、またはエンタープライズワークロード向けの Vertex AI 認証情報をサポートします。
• スクリプトとヘッドレスモード – 非対話型の -p フラグと JSON/ストリーム JSON 出力により、CI パイプラインへの組み込みが容易です。
• 拡張可能なツール – 組み込みのファイルシステム、シェル、Web フェッチツール。GEMINI.md によるカスタムコマンド。特定の機能のためのプラグイン MCP サーバー。
• IDE 統合とサンドボックス化 – VS Code コンパニオン、トークンキャッシュ、チェックポイント、安全な実行のための信頼済みフォルダーポリシー。

インストール（いずれかを選択）

# 一回限りの実行
npx @google/gemini-cli

# グローバル npm インストール
npm install -g @google/gemini-cli

# Homebrew (macOS/Linux)
brew install gemini-cli

その他のオプションには、MacPorts や、制限されたシステム向けの Anaconda ベースの環境が含まれます。

はじめに

# 現在のフォルダで起動（インタラクティブ REPL）
gemini

# 単一のプロンプトを非対話的に実行
 gemini -p "このコードベースのアーキテクチャを説明してください"

# スクリプト用の構造化出力
 gemini -p "すべての関数を一覧表示" --output-format json

--include-directories でスコープを制限したり、-m gemini-2.5-flash でモデルを選択したり、--output-format stream-json でイベントをストリーミングしたりできます。

認証オプション

1. Google OAuth – Google アカウントでサインインします（有料の Code Assist ライセンスに必要）。必要に応じて GOOGLE_CLOUD_PROJECT を設定します。
2. Gemini API キー – GEMINI_API_KEY をエクスポートして、モデルを直接選択し、使用量ベースの課金を行います。
3. Vertex AI – GOOGLE_API_KEY をエクスポートし、GOOGLE_GENAI_USE_VERTEXAI=true を設定して、エンタープライズグレードのセキュリティ、より高いレート制限、シームレスな GCP 統合を実現します。

典型的なワークフロー

1. REPL を起動 – gemini は、現在のディレクトリをコンテキストとして自動的に読み込むインタラクティブなチャットを開きます。
2. コードを依頼 – 例：FAQ.md を使用して質問に答える Discord ボットを書いてください。
3. 反復 – スラッシュコマンド（/help、/chat、/bug）または GEMINI.md で定義されたカスタムコマンドを使用します。
4. 自動化 – JSON 出力を使用して結果をプログラムで解析し、CI スクリプトに呼び出しを埋め込みます。

ツールの拡張

• GEMINI.md ファイルを介してカスタムコマンドを追加します。
• ~/.gemini/settings.json で MCP サーバーを登録して、新しいツール（Slack、データベースなど）を公開します。
• カスタム拡張機能 の下にリンクされているドキュメントに従って、拡張機能を構築および共有します。

コミュニティとサポート

• Apache 2.0 の下でオープンソース化されています。プルリクエストによる貢献を歓迎します。
• ドキュメントサイト：https://www.geminicli.com/docs
• 問題トラッカー、ロードマップ、セキュリティポリシーはすべて GitHub でホストされています。
• DeepLearning.AI を通じて無料の入門コースが利用可能です。

ステータスに関する注意 – Gemini CLI は最新の Gemini 4 Argon モデル向けに最適化されていません。Google はこれらのワークロードには新しい Antigravity CLI の使用を推奨しています。