このページは Cloud Translation API によって翻訳されました。

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 の構成

Gemini の実行に Cloud Shell を選択すると、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 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)

すぐに気づくことの 1 つは、Gemini CLI が必要に応じてこれらのツールを呼び出すことができるかどうかを自問することです。ローカルシステムへの書き込み、外部システムからの読み取り、外部ネットワークへのアクセスなど、機密性の高いオペレーションについては、デフォルトの回答は「いいえ」です。

CLI の起動時に --yolo を使用できますが（通常はおすすめしません）、Gemini CLI は選択したツールを実行する権限を求めるプロンプトを表示します。権限を拒否したり、1 回だけ実行したり、常に実行する包括的な権限を付与したりできます。すべてを完全に制御できる状態にすべきです。

Gemini CLI が実行する組み込みツールの 1 つを選択し、その仕組みを理解するのに役立つプロンプトを使用してみましょう。

世界中の最新の金融ニュースに関する情報を取得し、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 内から Shell を直接操作する方法を学習するのに最適なタイミングです。メッセージボックスで ! を押すと、シェルモードに切り替わります。シェルモードに切り替わります。! をもう一度押すか、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 に公開するアプリケーションです。これにより、外部システムやデータソースとやり取りできます。MCP サーバーは、Gemini モデルとローカル環境や API などの他のサービスとの間の橋渡し役として機能します。

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

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

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> のクローンを作成します。
@<ファイル名> または @<ディレクトリ名>/ を説明します。
このリポジトリのコンポーネントにはどのようなものがありますか？
必要な変更を行いました。変更を Github に push して、Github MCP Server ツールを使用して変更できますか？

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 拡張機能のほんの一例です。拡張機能ギャラリーで詳細を確認するか、「Gemini CLI 拡張機能を使ってみる」の Codelab をご覧ください。

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.

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

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

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 リポジトリの管理には、複数の Git コマンド（init、add、commit）が使用されます。
次に、Git リモートを設定して push を実行します。

注: Gemini CLI がタイムアウトしたり、間違ったユーザー名を使用したりする場合があります。その場合は、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 ファイルについて、その内容を読み取ります。日付が見つかった場合は、ファイルの名前を変更して、その日付を YYYY-MM-DD 形式で含めます（例: ‘invoice_2025-07-26_original_name.pdf'.