Question 1

移行したフックが Gemini CLI で 'Hook timed out after Xms' エラーで失敗するのはなぜですか？

Accepted Answer

`gemini hooks migrate` は、単位を変換せずに Claude Code の設定から `timeout` の値をコピーします。Claude Code はフックのタイムアウトを**秒**で測定しますが、Gemini CLI は**ミリ秒**を想定しているため、`30`（30 秒）のタイムアウトは 30 ミリ秒になり、ほぼすべてのフックコマンドがタイムアウトします。

**回避策（修正されるまで）：** `gemini hooks migrate` を実行した後、生成された Gemini の設定で各フックの `timeout` 値に手動で 1000 を掛けてください：

```json
// Claude Code（秒）
"timeout": 30

// Gemini CLI（ミリ秒）
"timeout": 30000
```

明示的に `timeout` を設定していない場合は影響を受けません — 両製品ともデフォルトは 60 秒 / 60000 ミリ秒です。

**適切な修正：** `packages/cli/src/commands/hooks/migrate.ts` のマイグレーターは、単位を変換する必要があります：`migrated["timeout"] = hook["timeout"] * 1000;`。`gemini-cli` 0.57.0 に影響します。

Question 2

Gemini CLI が起動後に settings.json 内の ${VAR} 環境変数プレースホルダーをリテラル値に置き換えるのはなぜですか？

Accepted Answer

Gemini CLI ≤0.63.0-nightly の既知のバグ (#29556): 起動時に非推奨キーが自動移行されると、それを含むサブツリー全体 (例: `ui`、`general`) が展開済みの settings ビューから書き換えられるため、`"autoThemeSwitching": "${TEST_AUTO_THEME:-false}"` のような兄弟キーがリテラルの `true`/`false` として保存され、変数が機能しなくなります。修正: PR #29564 を含むビルドにアップグレードしてください。この PR は `packages/cli/src/config/settings.ts` の `migrateDeprecatedSettings` を変更し、展開済みの `settings` ビューではなく `originalSettings` (生のファイルビュー) を読み取り/変更するようにするもので、実行時の値は展開されたまま維持しつつ、ディスク上の `${VAR}` プレースホルダーを保持します。それまでの回避策: (1) 起動前に非推奨キーを自分で手動で移行し、そのサブツリーで移行が実行されないようにする — 例: `ui.accessibility.disableLoadingPhrases: true` を `ui.accessibility.enableLoadingPhrases: false` と `ui.loadingPhrases: "off"` に置き換える。(2) 移行後に `~/.gemini/settings.json` を再編集して `${VAR:-default}` プレースホルダーを復元する。(3) `${VAR}` キーを、まだ非推奨キーが残っているサブツリーに入れないようにする。影響を受ける移行: `general.disableAutoUpdate`、`general.disableUpdateNag`、`context.fileFiltering.disableFuzzySearch`、`ui.accessibility.enableLoadingPhrases`、`tools.approvalMode`、および `experimental.*`。

Question 3

WSLを使用しているときに、VS CodeのGeminiが間違ったプロジェクトフォルダーにファイルを書き込むのはなぜですか？

Accepted Answer

これは確認済みのパス解決バグ（issue #25527）です。VS Code + WSL環境で、ワークスペースルートが複数のリポジトリを含む広範な親ディレクトリである場合、Geminiが相対パスを誤ったリポジトリに対して解決する可能性があります。UIにはアクティブなプロジェクト配下の期待どおりの相対パスが表示されますが、ファイルは実際には別のリポジトリに書き込まれます（例：現在のプロジェクトのtestsフォルダではなく、/home/user/repogit/other-repo/tests/file.txt）。報告者が確認した回避策：親ディレクトリやマルチルートワークスペースではなく、特定のプロジェクトフォルダをVS Codeのワークスペースルートとして直接開いてください（File > Open Folder > 対象プロジェクト、例：/home/jacques/repogit/mmm-tools/FLUX）。単一のプロジェクトをルートにすれば、ファイルは正しい場所に作成されます。公式修正がリリースされるまでの追加の安全策として、プロンプトでは絶対パスを指定し、Geminiが成功を報告した後にディスク上でファイルの実際の場所を確認してください。

Question 4

Gemini CLI拡張機能がgeminicli.comの拡張機能ギャラリーに表示されないのはなぜですか？

Accepted Answer

ギャラリークローラーは日次でクロールを行う外部サービス(gemini-cli コードベースの一部ではありません)であるため、インデックス登録の遅延に対してユーザー側でできる修正はありません。まず要件を確認してください:(1)リポジトリがパブリックであり、アーカイブ、無効化、フォークのいずれでもないこと;(2)GitHub トピック `gemini-cli-extension` が設定されていること;(3)有効な `gemini-extension.json` マニフェストがデフォルトブランチ(main または master)のルートに存在すること。次に、最新の Gemini CLI リリース(例:0.61.0)を使用してマニフェストをローカルで検証してください。ローカルでの検証に合格しても、ギャラリーへのインデックス登録が保証されるわけではない点に注意してください。数日間の日次クロールサイクルを経ても拡張機能が https://geminicli.com/extensions.json に表示されない場合は、google-gemini/gemini-cli で issue を作成し、リポジトリが検出されたのか、検証に失敗したのか、スキップされたのかをギャラリーチームに確認するよう依頼してください。検証エラーは現在、拡張機能の作者には表示されないためです。

gemini-cli

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト