Gemini CLI を使った実践演習

1. はじめに

この Codelab では、Gemini の機能をターミナルから直接利用できるオープンソースの AI エージェントである Gemini CLI について学習します。

学習内容

Gemini CLI のインストールと構成
Gemini CLI でのツール、組み込みコマンドの確認、MCP サーバーの構成
GEMINI.md ファイルを使用して Gemini CLI をカスタマイズする
Gemini CLI のユースケースをいくつか確認する

必要なもの

この Codelab は、Gemini CLI がプリインストールされた Google Cloud Shell 内ですべて実行できます。

独自のマシンで作業する場合は、Gemini CLI をローカルにインストールするセクションをご覧ください。

必要なものは次のとおりです。

Chrome ウェブブラウザ
Gmail アカウント

この Codelab は、初心者を含むあらゆるレベルのユーザーとデベロッパーを対象としています。この Codelab のユースケースは、デベロッパータスクとデベロッパー以外のタスクに分類されています。デベロッパーのユースケースでは、Gemini CLI を使用してコードをバイブする方法と、GitHub リポジトリを使用して、コードの説明/理解、ドキュメントの生成、問題の修正などの一般的な開発タスクを実行する方法を示します。この Codelab では、これらのユースケースを完了することをおすすめします。最後に、デベロッパー以外のユーザーを対象とした日常的なタスクをいくつか紹介するオプションのセクションがあります。

2. 始める前に

プロジェクトを作成する

Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
Cloud Shell（Google Cloud で動作するコマンドライン環境）を使用します。この環境には bq がプリロードされています。Google Cloud コンソールの上部にある [Cloud Shell をアクティブにする] をクリックします。

[Cloud Shell をアクティブにする] ボタンの画像

Cloud Shell に接続したら、次のコマンドを使用して、すでに認証済みであることと、プロジェクトがプロジェクト ID に設定されていることを確認します。

gcloud auth list

Cloud Shell で次のコマンドを実行して、gcloud コマンドがプロジェクトを認識していることを確認します。

gcloud config list project

プロジェクトが設定されていない場合は、次のコマンドを使用して設定します。

gcloud config set project <YOUR_PROJECT_ID>

3. インストール

設定を行って Gemini CLI を実行する前に、ホームフォルダとして使用するフォルダを作成します。このホームフォルダの中に、すべてのプロジェクトを作成します。ホームフォルダは Gemini CLI が動作するための開始点ですが、必要に応じてシステム上の他のフォルダも参照します。これについては後で説明します。

サンプルフォルダ（gemini-cli-projects）を作成し、以下のコマンドでそのフォルダに移動します。別のフォルダ名を使用する場合は、そのようにしてください。

mkdir gemini-cli-projects

そのフォルダに移動します。

cd gemini-cli-projects

gemini コマンドを使用して、Gemini CLI を直接起動できます。

次のセクション（settings.json による Gemini CLI の構成）に直接移動してください。

Gemini CLI をローカルにインストールする場合は、以下の手順に沿って操作します。

まず、マシンに Node 20 以降をインストールします。完了したら、次のいずれかの方法で Gemini CLI をインストールして実行できます。

まず、システムに Gemini CLI をグローバルにインストールできます。この手順を行うには、管理者権限が必要になることがあります。

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

次のコマンドで実行します。

# option 2: run without installing Gemini CLI

npx https://github.com/google-gemini/gemini-cli

次のコマンドを実行して、CLI がインストールされていることを確認できます。

gemini --version

上記の方法で Gemini CLI を起動すると、テーマの選択を求める次の画面が表示されます。お好みのものを選択してください。

選択すると、認証方法を尋ねられます。このラボでは、Google 以外の関連アカウントや Google Workspace 関連アカウントではなく、個人の Google アカウントを使用することをおすすめします。この無償ライセンスがあれば、Gemini 2.5 Pro と、100 万トークンのコンテキストウィンドウを利用できます。無料枠では、1 分あたり 60 件のモデルリクエストと 1 日あたり 1,000 件のリクエストを無料で利用できます。

Google アカウントに付与されている現在の無料割り当ての上限に達した場合は、Gemini API キーまたは Google Cloud Vertex AI を使用できます。この場合、プロジェクト ID とそのプロジェクトのロケーション名が必要になります。他の認証方法を使用する場合は、ドキュメントの認証セクションを参照してください。

[Enter] をクリックします。ブラウザで Google 認証ページが開きます。Google アカウントで認証を行い、利用規約に同意します。認証に成功すると、Gemini CLI がコマンドを受け付ける状態になります。以下に、スクリーンショットの例を示します。

4. settings.json による Gemini CLI の構成

Cloud Shell を選択して Gemini を実行する場合、Gemini CLI のデフォルトのテーマと認証方法がすでに選択され、構成されています。

マシンに Gemini CLI をインストールして初めて起動した場合は、テーマと認証方法を選択します。

これで、Gemini CLI を次回以降実行するときに、テーマと認証方法の選択を求められることはありません。つまり、設定はどこかに保存され、使用されるファイルは settings.json と呼ばれます。これは Gemini CLI をカスタマイズする方法です。

設定は次の優先順位で適用されます（Cloud Shell ではユーザー設定のみが使用可能です）。

システム: /etc/gemini-cli/settings.json（すべてのユーザーに適用され、ユーザーとワークスペースの設定をオーバーライドします）。
ワークスペース: .gemini/settings.json（ユーザー設定をオーバーライドします）。
ユーザー: ~/.gemini/settings.json。

Windows ユーザー: %USERPROFILE%.gemini\settings.json（通常は C:\Users<ユーザー名>.gemini\settings.json に展開されます）

システム: %ProgramData%\gemini-cli\settings.json（通常は C:\ProgramData\gemini-cli\settings.json に展開されます）

Mac ユーザー: ~/.gemini/settings.json（/Users/<ユーザー名>/.gemini/settings.json に展開されます）

システム: /etc/gemini-cli/settings.json

テーマを選択したときに、設定をユーザー設定に保存するように選択したことを思い出してください。~/.gemini folder にアクセスすると、settings.json ファイルが表示されます。

settings.json ファイルを以下に示します。別のテーマを選択していた場合は、その名前が表示されます。

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal" or "cloud-shell"
}

5. Gemini CLI との最初のインタラクション

Gemini CLI を起動し、次のように最初のクエリを入力します。

Give me a famous quote on Artificial Intelligence and who said that?

想定されるレスポンスは次のとおりです。

GoogleSearch Searching the web for: "famous quote on Artificial Intelligence and who said it"                                                                                                                 ...
Search results for "famous quote on Artificial Intelligence and who said it" returned.                                                                                                                             

✦ "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking.

クエリの結果、GoogleSearch ツール（Gemini CLI の組み込みツール）が呼び出されました。つまり、Gemini CLI の強力な組み込みツールの 1 つである GoogleSearch をすでに使用しています。このツールは、ウェブから取得した情報に基づいて回答を生成します。ツールについては、次のセクションで詳しく説明します。

Gemini CLI と、サポートされているコマンドを確認したい場合は、先頭にスラッシュを付けて「/help」と入力するだけで、利用可能なコマンドやキーボードショートカットの一覧が表示されます。

ここでは Gemini CLI を終了します。これを行うには、/quit コマンドを使用するか、インタラクティブな Gemini CLI ターミナルセッションで Ctrl-C を 2 回実行します。

6. Gemini CLI - コマンドパラメータ

Gemini CLI を起動するときに指定できるコマンドラインパラメータがいくつかあります。オプションの全リストを取得するには、次のように --help を使用します。

gemini --help

これにより、利用可能なすべてのオプションが表示されます。こちらのドキュメントをご覧ください。

そのうちのいくつかを見てみましょう。1 つ目は、Pro モデルまたは Flash モデルを使用するように Gemini CLI を構成することです。このラボの作成時点では、サポートされているモデルはこれら 2 つのみです。デフォルトでは Gemini 2.5 Pro モデルが使用されますが、Flash モデルを使用する場合は、次のように -m パラメータを使用して Gemini CLI の起動時に指定できます。

gemini -m "gemini-2.5-flash"

上記の方法で開始すると、Gemini CLI ターミナルの右下でモデルを確認できます（次の図を参照）。

Gemini CLI アプリケーションを開いたら、/model コマンドを使用して、モデルを選択できるダイアログを開きます。サンプル実行を以下に示します。要件とガイダンスに応じて、モデルを切り替えて、複雑さと費用管理の必要性に応じてタスクに適したモデルを選択できます。

非インタラクティブモード

Gemini CLI には、非インタラクティブモードで実行するオプションもあります。このモードでは、プロンプトを直接指定することで、Gemini CLI のインタラクティブターミナルを開かずに Gemini が回答します。スクリプトやその他の自動化プロセスの一部として Gemini CLI を自動的に使用する場合に非常に便利です。-p パラメータを使用して、次の例のように Gemini CLI にプロンプトを指定します。または、位置引数を使用してプロンプトを指定します。

gemini "What is the gcloud command to deploy to Cloud Run"

フォローアップの質問で会話を続けることはできないことに注意してください。このモードでは、ツール（WriteFile を含む）の認証やシェルコマンドの実行もできません。

7. Gemini CLI - 組み込みツール

Gemini CLI には一連の組み込みツールが用意されています。ツールのドキュメントには、「Gemini モデルはこれらのツールを使用してローカル環境と連携し、情報の取得や各種アクションを実行します。これらのツールは CLI の機能を強化し、テキスト生成だけでなく、幅広いタスクの支援にも役立ちます。」

現在の組み込みツールの一覧を取得するには、以下に示すように /tools コマンドを呼び出します。

Available Gemini CLI tools:

  - Codebase Investigator Agent (codebase_investigator)
  - Edit (replace)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SaveMemory (save_memory)
  - SearchText (search_file_content)
  - Shell (run_shell_command)
  - WebFetch (web_fetch)
  - WriteFile (write_file)
  - WriteTodos (write_todos)

まず、Gemini CLI がこれらのツールを必要に応じて簡単に呼び出せるかどうかを自問する必要があります。ローカルシステムへの書き込み、外部システムからの読み取り、外部ネットワークへのアクセスなど、機密性の高い操作を行う場合、デフォルトの回答は「いいえ」です。

CLI を起動するときに --yolo を使用できます（通常は推奨されません）。この場合、Gemini CLI は選択したツールを実行する際に、権限を求めるメッセージを表示します。権限を拒否する、1 回だけ実行する、包括的な権限を付与して常に実行する、のいずれかを選択できます。これにより、すべてを完全に制御できます。

Gemini CLI に組み込みツールを 1 つ選択して実行させるプロンプトを使用します。これにより、Gemini CLI の仕組みを理解できます。

たとえば、世界中の最新の金融ニュースに関する情報を取得し、Gemini CLI を起動したローカル作業ディレクトリ内のファイルに保存するとします。次のプロンプトを使用します。

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

このツールが何をするべきかを考えてみましょう。理想的には、Google 検索を実行して、金融ニュースを提供できる関連性の高い情報源からニュースを取得する必要があります。次に、そのコンテンツを含む finance-news-today.txt という名前のファイルを作成する必要があります（ローカルシステムへの書き込みオペレーションには権限が必要です）。

結果を見てみましょう（ご自身のマシンでも同じ操作を行ってください）。

まず、GoogleSearch ツールを呼び出してウェブを検索し、結果を取得します。

GoogleSearch Searching the web for: "latest finance headlines today"                                                                                                                                            

Search results for "latest finance headlines today" returned.

その後、ファイルに書き込む準備が整うと、WriteFile ツールが使用されます。書き込みは機密性の高い操作であるため、実行には権限が必要です。権限は、1 回のみ許可する、常に許可するなど、必要に応じて選択できます。ここでは、[1 回のみ許可] を選択します。

その後、情報がファイルに書き込まれ、次のような成功メッセージが表示されます。

✦ I have successfully saved the latest finance headlines into the file finance-news-today.txt.

ファイルが書き込まれているかどうかを確認するにはどうすればよいですか？@file を使用して、コンテンツの読み上げをリクエストできます。また、「@」と入力すると、作成したファイルを含む現在のフォルダ内のファイル一覧が表示されます。そのコースを選択して、プロンプトを送信します。プロンプトは次のとおりです。

read the contents of @finance-news-today.txt

これにより、必要なツール（ReadManyFiles、ReadFile）が呼び出され、次のようにコンテンツが表示されます。

8. Gemini CLI - シェルモード

Gemini CLI から直接シェルを操作する方法を学習するのに最適なタイミングです。メッセージボックスで ! を押すと、シェルモードに切り替わります。シェルモードに切り替わります。! をもう一度押すか、ESC キーを押すと、前の画面に戻ることができます。

シェルモードでは、以下に示すようにプロンプトの先頭に ! が表示されます。

次の例に示すように、pwd や ls などの標準コマンドを使用して直接確認できます。コマンドは Linux タイプの OS を想定しています。別のオペレーティングシステム（Windows）を使用している場合は、同等のコマンド（cd、dir、type など）を使用してください。これらの呼び出しの出力は、モデルのコンテキストウィンドウに含まれます。

現時点では、cat コマンドを使用してファイルの内容を出力できます。

演習: 以下の演習を試してください。任意の RSS フィードを選択します。Gemini CLI にプロンプトを入力して、RSS フィードのコンテンツを取得し、特定の方法で結果をフォーマットします。これは、1 日の始まりに何かを自動化するのに適した方法です。Gemini CLI に、特定の分野（Google Cloud Platform リリースノートなど）の RSS フィードがあるかどうかを尋ねることもできます。

プロンプトの例を以下に示します。

Get the latest release notes for Google Cloud from its RSS Feed and display the key points in a well-formatted list.

このプロンプトは、まず GoogleSearch ツールを呼び出して Google Cloud Platform の RSS フィードを見つけ、次に WebFetch ツールを使用して RSS フィードのコンテンツを取得して表示します。

9. Gemini CLI 拡張機能

ドキュメントに記載されているように、Gemini CLI 拡張機能は、プロンプト、MCP サーバー、カスタムコマンドを使い慣れたユーザーフレンドリーな形式にパッケージ化したものです。拡張機能を使用することで、Gemini CLI の機能を拡張し、他のユーザーと共有できます。これは、Gemini CLI の機能を組み込みツールを超えて拡張するための主要なメカニズムです。

拡張機能は、自己完結型でバージョン管理が可能で、簡単に配布できるパッケージです。これは、Gemini CLI のカスタマイズの「輸送コンテナ」のようなもので、特定のワークフローに必要なものをすべて 1 つの整然としたパッケージにバンドルします。

拡張機能は、次の任意の組み合わせをバンドルできます。

カスタムスラッシュコマンド（.toml ファイル）。
MCP サーバー構成（以前は settings.json に存在していました）。
モデルに具体的な指示とガイドラインを提供するコンテキストファイル（GEMINI.md）。
より安全で集中しやすい環境を構築するためのツール制限（excludeTools）。

拡張機能ギャラリーを見る

拡張機能ギャラリーは、Google が作成した公式の拡張機能とサードパーティの拡張機能をすべて見つけることができる中央のマーケットプレイスです。

ブラウザで次の URL（https://geminicli.com/extensions/browse/）を開きます。
このギャラリーは、エコシステムの検出エンジンです。GitHub、Redis、DynaTrace などの企業の拡張機能が表示され、利用可能なツールの幅広さがわかります。
下にスクロールして、Cloud Run の拡張機能カードを見つけます。
カードには、説明、作成者（Google）、ワンクリックの Copy コマンドボタンが表示されます。これが拡張機能のインストールコマンドを取得する最も簡単な方法です。

Gemini CLI 拡張機能 - 管理コマンド

gemini extensions コマンドは、ローカル拡張機能を管理するためのエントリポイントです。

ターミナルで実行すると、使用可能なコマンドのリストが表示されます。

gemini extensions <command>

Manage Gemini CLI extensions.

Commands:
  gemini extensions install <source> [--auto-update] [--pre-release]   
      Installs an extension from a git repository URL or a local path.
  gemini extensions uninstall <names..>                                  
      Uninstalls one or more extensions.
  gemini extensions list
      Lists installed extensions.
  gemini extensions update [<name>] [--all]                           
      Updates all extensions or a named extension to the latest version.
  gemini extensions disable [--scope] <name>                          
      Disables an extension.
  gemini extensions enable [--scope] <name>                           
      Enables an extension.
  gemini extensions link <path>                                       
     Links an extension from a local path. Updates made to the local path 
     will always be reflected.
  gemini extensions new <path> [template]                             
     Create a new extension from a boilerplate example.
  gemini extensions validate <path>                                   
     Validates an extension from a local path.

コマンドは簡単です（インストール/アンインストール、リスト、更新、有効/無効など）。この Codelab では、これらのコマンドの一部を使用します。

現在の拡張機能のリストを確認する

インストールを行う前に、「クリーンな状態」を確認しましょう。

gemini extensions list コマンドを実行します。
次の出力が表示され、拡張機能がまだインストールされていないことが確認されます。

No extensions installed.

GitHub MCP サーバーの構成

Gemini CLI 拡張機能のタイプの 1 つに MCP サーバーがあります。MCP サーバーは、Model Context Protocol を介してツールやリソースを Gemini CLI に公開するアプリケーションです。これにより、Gemini CLI は外部のシステムやデータソースとやり取りできるようになります。MCP サーバーは、Gemini モデルとローカル環境または API などの他のサービスをつなぐ役割を果たします。

GitHub MCP サーバーは Gemini 拡張機能ギャラリーで利用できます。クリックすると、拡張機能カードが開き、拡張機能をインストールするコマンドも表示されます。

コピーするか、次のコマンドを使用します。

gemini extensions install https://github.com/github/github-mcp-server

必要な権限を付与して続行します。インストールが完了すると、gemini extensions list コマンドを実行したときに、拡張機能のリストにこの拡張機能が表示されます。

✓ github (1.0.0)
 ID: faa318861b48de8d83c95eb8cd5e82c02393493978d198a0e7bf67fcb1bd22cb
 name: c0b0109d9439de57fe3cf03abeccbc52f4c98170c732d3b69af5e6395ace574e
 Path: /home/romin/.gemini/extensions/github
 Source: https://github.com/github/github-mcp-server (Type: git)
 Enabled (User): true
 Enabled (Workspace): true
 MCP servers:
  github

拡張機能のパスが表示されます。そのフォルダには gemini-extension.json という名前のファイルがあり、その内容は次のとおりです。

{
  "name": "github",
  "version": "1.0.0",
  "mcpServers": {
    "github": {
      "description": "--description–",
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
            "Authorization": "Bearer $GITHUB_MCP_PAT"
      }
     }
  }
}

環境変数を使用して個人用アクセストークン（PAT）が読み取られていることがわかります。まず、GitHub の個人用アクセストークン（PAT）を用意します。取得したら、.env ファイルを作成してこの値を配置するか、次のように環境変数を作成します（PAT_VALUE は実際の値に置き換えます）。

export GITHUB_MCP_PAT=PAT_VALUE

Gemini CLI を再起動する必要があります。起動したら、/mcp list コマンドを使用して、使用可能な MCP サーバーとそのツールの一覧を表示できます。GitHub MCP サーバーが緑色で表示され、そのツール（30 個以上）も表示されます。以下に一部を示します。

🟢 github（github から）- 準備完了（40 個のツール）

ツール:

add_comment_to_pending_review
add_issue_comment
assign_copilot_to_issue
create_branch
create_or_update_file
create_pull_request
create_repository
delete_file
fork_repository
get_commit
get_file_contents
get_label
get_latest_release
get_me
get_release_by_tag
get_tag
get_team_members
get_teams
issue_read

まず、GitHub MCP サーバーのツールを 1 つ呼び出すプロンプトから始めましょう。次のプロンプト（GitHub における私の名前は？）を入力します。これにより、Gemini CLI が適切なツールを選択し、ユーザーに権限を求めます。

承認すると、次のように結果が取得されます。

✦ You are rominirani, a Developer Advocate at Google Cloud, located in Mumbai. You have 125 public repositories and 256 followers.

これで、GitHub プロジェクトのいずれかを使用できるようになりました。次のように自然言語でクエリを指定します。

<repo-name> について説明して。
ローカルマシンに <repo-name> のクローンを作成して。
@<file-name> や @<directory-name>/ について説明して。
このリポジトリのコンポーネントにはどのようなものがありますか。
必要な変更を加えました。GitHub MCP サーバーツールを使って、この変更を GitHub に push できますか。

GitHub MCP サーバーを操作する演習については、このラボの後半で詳しく説明します。

Cloud Run MCP サーバーの構成

Gemini CLI 拡張機能ギャラリーで利用可能な Cloud Run 拡張機能は、アプリケーションを Cloud Run にデプロイできる MCP サーバーです。

以下は、拡張機能ギャラリーの Cloud Run 拡張機能カードです。

まず、上の図のように [インストールコマンドをコピー] をクリックして、Cloud Run 拡張機能をインストールします。次に、そのコマンドを Cloud Shell ターミナルに貼り付けます（次のようになります）。

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

上記のコマンドを実行すると、確認が必要なメッセージが表示されます。承認してください。Cloud Run 拡張機能が正常にインストールされます。

ここで gemini extensions list コマンドを実行すると、次のように Cloud Run 拡張機能がインストールされていることがわかります。

✓ cloud-run (1.0.0)
 ID: 3c1a38909b6d7d90b6acc8ca1e80d97b4a867253a3cd12d841b2aab4e556a58f
 name: 0b1820c1f0c043bbb3b54f496d862c02172424c930eb965d61f468be52e6f127
 Path: /home/romin/.gemini/extensions/cloud-run
 Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: git)
 Enabled (User): true
 Enabled (Workspace): true
 Context files:
  /home/romin/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
 MCP servers:
  cloud-run

ここで Gemini CLI を起動して /mcp list コマンドを実行すると、次のようになります。

🟢 cloud-run (from cloud-run) - Ready (8 tools, 2 prompts)
  Tools:
  - create_project
  - deploy_container_image
  - deploy_file_contents
  - deploy_local_folder
  - get_service
  - get_service_log
  - list_projects
  - list_services
  Prompts:
  - deploy
  - logs

上記は、構成方法を示した Gemini CLI 拡張機能のほんの一例です。拡張機能ギャラリーで詳細を確認するか、Codelab「Gemini CLI 拡張機能を使ってみる」をお試しください。

10. 試してみるユースケース

Gemini CLI は、デベロッパーとデベロッパー以外の両方に適用される幅広いユースケースに適用できます。ここではいくつかのシナリオを紹介します。興味のある分野に応じて、これらのシナリオをすべて試すことも、一部だけを試すこともできます。

いずれの場合も、プロンプトが提供されます。Gemini CLI の起動時に -p パラメータを使用して、Gemini CLI のインタラクティブモードまたは非インタラクティブモードでこの機能を試すことができます。

Gemini CLI を使用したバイブコーディング

Gemini CLI を使用してアプリケーションのバイブコーディングを行いましょう。このタスクでは、Gemini CLI にアプリケーションの生成を依頼し、最初のバージョンを GitHub リポジトリに push します。

要件

このセクションのタスクを実行するには、いくつかの前提条件があります。

Git
GitHub Gemini CLI 拡張機能を使用する Gemini CLI（先ほど実行しました）または gh（GitHub CLI ツール）を設定している場合も、同様に機能します。
Git の基本とプログラミングの知識

ここでは、任意の特定のフォルダで Gemini CLI を起動していることを前提とします。

最初のプロンプトから始めます。必要に応じて変更してください。Gemini CLI とのセッションでは、ファイルの作成などの権限を求められることがあります。必要な権限を付与してください。

このタスクでは、アプリケーションの実行やテストを Gemini CLI に任せることはしません。もう少し制御したいからです。ただし、この操作を行うかどうかはユーザーの判断に委ねられています。

Generate a website for a 1-day event filled with technical talks. There are going to be 6 talks in a single track of 1 hour each. Each talk has the following information: title, 1 or maximum of 2 speakers, category (1 or maximum of 3 keywords), duration and a description. The website has a single page where users can see the schedule for the entire day with the timings. There will be one lunch break of an hour and the event starts at 10:00 AM. Keep a 10 minute transition between talks. I would like to use Node.js on the server side and standard HTML, JavaScript and CSS on the front-end. The users should be able to search the talks based on category.

I would like you to proceed in the following way: 
1. Plan out how you would design and code this application.
2. Ask me for any clarifications along the way.
3. Once I am fine with it, do generate the code and provide me instructions to run and test locally.

次のプロンプトと回答は、観察されたサンプルフローです。Gemini CLI が計画を立て、確認や説明を求めたり、続行を求めたりします。手順に沿って操作してください。以下は会話スレッドの例です。

   1. Backend (Node.js/Express):
       * Set up an Express server to serve the static frontend files.
       * Create an /api/schedule endpoint that will:
           * Generate the event schedule dynamically, including talk timings and the lunch break, based on your requirements.
           * Store mock talk data (title, speakers, category, description).
           * Filter the schedule based on a category query parameter.

   2. Frontend (HTML, CSS, JavaScript):
       * Create an index.html file for the main structure.
       * Develop style.css for a clean and responsive design.
       * Write script.js to:
           * Fetch the schedule data from the backend.
           * Dynamically render the talks and lunch break on the page.
           * Implement a search input that filters talks by category, updating the displayed schedule without a full page reload.

   3. Schedule Logic:
       * The backend will handle calculating the precise start and end times for each 1-hour talk, factoring in the 10:00 AM start, 10-minute transitions, and the 1-hour lunch break.

  Before I proceed with the code, could you please clarify the following:

   * Example Talk Data: Could you provide some example talk titles, speakers, categories (keywords), and descriptions? This will help me create realistic dummy data for the schedule.
   * Lunch Break Placement: Where should the 1-hour lunch break be placed in the schedule? (e.g., after the 3rd talk, at 1 PM, etc.)
   * Styling Preferences: Do you have any specific styling preferences (e.g., color scheme, modern/minimalist, etc.)? If not, I will go with a clean, simple design.

✦ I will create a single-page website for your event. Here's my plan:

✓  WriteTodos Set 7 todo(s)                                                                                                                                                                                        

✦ I am waiting for your clarifications regarding the example talk data, lunch break placement, and styling preferences before I proceed with generating the code.

最後に、次のような要約が表示されました。

✦ Instructions to Run and Test Locally:

   1. Start the server:
      Open your terminal in the project directory (/home/romin/gemini-cli-projects/event-website/) and run:
   1     node server.js
      You should see a message in the terminal indicating: Server running on http://localhost:3000.

   2. Open in your browser:
      Open your web browser and navigate to:
      http://localhost:3000

   3. Test functionality:
       * You should see the event schedule displayed on the page, with talks and a lunch break.
       * Search by category: In the "Search by category..." input box, type a category keyword (e.g., "AI", "Web Development", "Python", "Security").
       * Click the "Search" button. The schedule displayed should filter to only show talks matching that category.
       * Click the "Reset" button to clear the search filter and view the full schedule again.

  Let me know if you encounter any issues or if you'd like to make any modifications or additions to the website!

手順に沿ってサーバーを起動し、ホームページに移動すると、図のようなサンプルサイトが表示されます（同じプロンプトを使用した場合、類似のサイトのバリエーションが表示されます）。

Gemini CLI を使用して、さらに変更を加えることも可能です。変更に問題がなければ、GitHub リポジトリに push できます。

まず、.gitignore ファイルを作成します。Gemini CLI を使用できます。

Create a .gitignore file for this project.

次のステップとして、このリポジトリを GitHub アカウントに push するよう Gemini CLI に指示します。これにより、バックグラウンドで GitHub MCP サーバーツールが実行されます。

次のようなプロンプトを入力します。

Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app

ここでは、次のコマンドを実行します。

リポジトリを作成します。
ローカル Git リポジトリを管理するために、init、add、commit などの複数の Git コマンドを使用します。
次に、Git リモートを設定して push を実行します。

注: Gemini CLI がタイムアウトする場合や、ユーザー名が誤って使用される場合があります。その場合は、操作を行い、修正を提案してください。

問題がなければ、GitHub リポジトリが作成されているはずです。以下に、スクリーンショットの例を示します。

このプロジェクトの README.md は生成していません。これは次のセクションで取り組むとよいでしょう。次のセクションでは、作成したばかりのリポジトリを操作します。

Gemini CLI を使用して GitHub リポジトリを操作する

このユースケースでは、Gemini CLI を使用して GitHub リポジトリを操作します。次のタスクを行います。

コードベースを理解する
ドキュメントの生成
新機能の実装
変更を commit してリポジトリに push して戻します。
GitHub の Issue に取り組み、提案された変更を実装する

これにより、リポジトリを操作し、これらのデベロッパー固有のタスクで Gemini CLI をアシスタントとして使用するための基盤が整います。

要件

このセクションのタスクを実行するには、次のものが必要です。

Git
GitHub MCP Gemini CLI 拡張機能を使用する Gemini CLI（先ほど実施済み）または gh（GitHub CLI ツール）を設定している場合も、同様に機能します。
Git の基本とプログラミングの知識（この例では Node.js を使用します。Gemini CLI をインストールしているため、マシンに環境がすでに準備されている可能性があります）。後で、別のプログラミング言語とフレームワークを使用して、任意のリポジトリを選択することもできます。
前のセクションを完了し、Event Talks ウェブサイトを作成したリポジトリを手元に用意しておく必要があります。

Event Talks アプリケーションの生成に使用したフォルダ/ディレクトリから Gemini CLI を引き続き使用します。必要に応じて、リポジトリをローカルマシンにクローンしてから、そのディレクトリから Gemini CLI を起動することもできます。以下のシナリオを試してください。

コードベースを理解する

このプロジェクトについて詳しく知りたいです。主な機能について説明し、サーバーサイドとクライアントサイドに分けてください。サンプルフローを使用して、リクエストとレスポンスの仕組みを説明してください。
Explain @server.js

README ファイルの生成

このプロジェクトの README ファイルを生成します。

新機能の実装

ユーザーが特定のスピーカーで検索できる新機能を実装したいと考えています。まず、この変更を実装する方法の計画を示してください。その後、コードを生成します。

プランが提示されるので、承認します。承認されると、Gemini CLI は変更を適用します。変更をテストし、バグ（可能性が高い）がある場合は、Gemini CLI に修正を依頼してください。

変更内容が適切であることを確認したら、同じ手順で commit してリモートリポジトリに push できます。

提案された機能に基づいて問題を生成する

ここで面白いことを試してみましょう。Gemini CLI に、このアプリケーションのユーザーエクスペリエンスを改善する方法を尋ねます。Gemini CLI は、その評価に基づいて、同じ GitHub リポジトリに問題として提案を作成します。GitHub MCP サーバーの「create_issue」ツールを使用します。

次のプロンプトを試してください。

ユーザーエクスペリエンスの観点からアプリケーションを評価していただきたいです。使いやすさ、応答性、役立つメッセージなど。改善点のリストを作成し、GitHub リポジトリで Issue として作成してください。

理想的には、まず改善点を共有し、許可を得てから GitHub リポジトリで問題を作成します。実行時のスクリーンショットの例を次に示します。

GitHub の Issue に取り組み、提案された変更を実装する

これで、以前に生成された問題の 1 つを取り上げ、Gemini CLI にその問題の解決と実装を依頼できます。

生成された問題の例を以下に示します。

問題の URL 全体をコピーして、次のようなプロンプトを入力します。

問題: <YOUR_ISSUE_URL> を確認し、必要な変更を理解してください。まずプランについて説明し、次に提案された変更をコードで示します。

変更を承認してリポジトリに push してください。問題をクローズするよう依頼することもできます。

（省略可）日常的なタスク

以下のユースケースは、定期的に行う可能性のあるタスクです。たとえば、ファイルをフォルダに整理する、ウェブからコンテンツを取得して要約する、画像ファイルを処理してコンテンツを抽出する、データベースを操作するなどのタスクがあります。

ご興味のあるユースケースを自由にご覧ください。

ファイル/フォルダの整理

Gemini CLI を使用すると、必要に応じて、さまざまなフォルダ内のタイプに応じてファイルを整理できます。パソコンのフォルダに移動し、.txt、.png、.jpg、.pdf、.mp4 などのファイルが複数あることを確認します。通常はデスクトップまたはダウンロードフォルダです。

フォルダの例とフォルダの内容を以下に示します（他のファイルが含まれている場合もあります）。

そのフォルダに移動して、Gemini CLI を起動します。まず、Gemini CLI に Images、Documents、Videos というフォルダを作成するよう依頼し、次に、Gemini CLI にフォルダ内のファイルを整理するよう依頼します。

Gemini CLI は、コマンドを実行する前に、特にファイルシステムを変更するコマンド（ファイルの書き込み、移動、削除など）を実行する前に、権限を求めるプロンプトを表示することがよくあります。権限を付与する前に、これらのプロンプトを必ずよく確認してください。これは安全ネットです。

Create the following folders "Images","Documents","Videos"

次のプロンプトを入力します。

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

フォルダの最終的な状態の例を以下に示します。新しいサブフォルダが作成され、ファイルが種類に応じてそれぞれのサブフォルダに移動されます。

その他の整理シナリオ（各シナリオの横にプロンプトが表示されます）:

要約: 「Documents」フォルダ内の各ドキュメントについて、ドキュメントの要点を 3 文で要約した「summary_ORIGINAL_FILENAME.txt」という名前の txt ファイルを同じフォルダに作成します。
タイプ別に分類: このディレクトリ内のすべての PDF ファイルと DOCX ファイルをスキャンします。名前またはコンテンツに「invoice」が含まれるすべてのファイルを「Financial/Invoices」フォルダに移動します。「receipt」を含むファイルを [Financial/Receipts] に移動します。その他の .docx ファイルは [Reports] に移動します。
キー情報の抽出（および「タグ付け」）: 「Financial/Invoices」フォルダ内の各 PDF ファイルについて、その内容を読み取ります。日付が見つかった場合は、ファイル名を「invoice_2025-07-26_original_name.pdf」のように、YYYY-MM-DD 形式で日付を含む名前に変更します。