Skip to content

README_jp.md

Latest commit

 

History

History
278 lines (213 loc) · 13.5 KB

README_jp.md

File metadata and controls

278 lines (213 loc) · 13.5 KB
Raw
Gemini CLI UI

Gemini CLI UI

Gemini CLI GoogleのAI支援コーディング用公式CLIのデスクトップ・モバイル対応UIです。ローカルまたはリモートで使用でき、Gemini CLIのアクティブなプロジェクトとセッションを表示し、CLIと同じように変更を加えることができます。どこでも動作する適切なインターフェースを提供します。

Screenshots

Chat View

Desktop Interface
Main interface showing project overview and chat

Setting

Mobile Interface
Setting

Chat View

Desktop Interface
Gemini CLI UI Diagram

機能

  • レスポンシブデザイン - デスクトップ、タブレット、モバイルでシームレスに動作し、モバイルからもGemini CLIを使用可能
  • インタラクティブなチャットインターフェース - Gemini CLIとのシームレスな通信のための組み込みチャットインターフェース
  • 統合シェルターミナル - 組み込みシェル機能によるGemini CLIへの直接アクセス
  • ファイルエクスプローラー - シンタックスハイライトとライブ編集機能を備えたインタラクティブなファイルツリー
  • Gitエクスプローラー - 変更の表示、ステージング、コミット。ブランチの切り替えも可能
  • セッション管理 - 会話の再開、複数セッションの管理、履歴の追跡
  • モデル選択 - Gemini 2.5 Proを含む複数のGeminiモデルから選択可能
  • YOLOモード - 確認プロンプトをスキップして高速操作（注意して使用）

クイックスタート

前提条件

  • Node.js v20以上
  • Gemini CLIがインストールされ、設定済みであること

インストール

  1. リポジトリをクローン：
git clone git@github.com:cruzyjapan/Gemini-CLI-UI.git
cd geminicliui
  1. 依存関係をインストール：
npm install
  1. 環境設定：
cp .env.example .env
# お好みの設定で.envを編集

注意: .envファイルはセキュリティのため削除されています。使用時は必ず.env.exampleをコピーして.envを作成し、必要に応じて設定を変更してください。

  1. アプリケーションを起動：
# 開発モード（ホットリロード付き）
npm run dev

アプリケーションは.envで指定したポートで起動します

  1. ブラウザを開く：
    • 開発環境: http://localhost:4009

セキュリティとツール設定

🔒 重要なお知らせ: すべてのGemini CLIツールはデフォルトで無効になっています。これにより、潜在的に有害な操作が自動的に実行されることを防ぎます。

ツールの有効化

Gemini CLIの全機能を使用するには、手動でツールを有効にする必要があります：

  1. ツール設定を開く - サイドバーの歯車アイコンをクリック
  2. 必要に応じて有効化 - 必要なツールのみをオンにする
  3. 設定を適用 - 設定はローカルに保存されます

YOLOモードについて

YOLOモード（「You Only Live Once」）は、Gemini CLIの --yolo フラグに相当し、すべての確認プロンプトをスキップします。このモードは作業を高速化しますが、注意して使用してください。

推奨アプローチ: 基本的なツールから始めて、必要に応じて追加していきます。設定はいつでも調整できます。

使用ガイド

コア機能

プロジェクト管理

UIは ~/.gemini/projects/ からGemini CLIプロジェクトを自動的に検出し、以下を提供します：

  • ビジュアルプロジェクトブラウザー - メタデータとセッション数を含むすべての利用可能なプロジェクト
  • プロジェクトアクション - プロジェクトの名前変更、削除、整理
  • スマートナビゲーション - 最近のプロジェクトとセッションへのクイックアクセス

チャットインターフェース

  • レスポンシブチャットまたはGemini CLIを使用 - 適応されたチャットインターフェースを使用するか、シェルボタンを使用してGemini CLIに接続できます
  • リアルタイム通信 - WebSocket接続によるGeminiからのストリームレスポンス
  • セッション管理 - 以前の会話を再開するか、新しいセッションを開始
  • メッセージ履歴 - タイムスタンプとメタデータを含む完全な会話履歴
  • マルチフォーマットサポート - テキスト、コードブロック、ファイル参照
  • 画像添付 - チャットで画像をアップロードして質問可能

ファイルエクスプローラーとエディター

  • インタラクティブファイルツリー - 展開/折りたたみナビゲーションでプロジェクト構造を閲覧
  • ライブファイル編集 - インターフェース内で直接ファイルを読み取り、変更、保存
  • シンタックスハイライト - 複数のプログラミング言語をサポート
  • ファイル操作 - ファイルとディレクトリの作成、名前変更、削除

Gitエクスプローラー

  • 変更の可視化 - 現在の変更をリアルタイムで表示
  • ステージングとコミット - UIから直接Gitコミットを作成
  • ブランチ管理 - ブランチの切り替えと管理

セッション管理

  • セッション永続性 - すべての会話を自動的に保存
  • セッション整理 - プロジェクトとタイムスタンプでセッションをグループ化
  • セッションアクション - 会話履歴の名前変更、削除、エクスポート
  • クロスデバイス同期 - どのデバイスからでもセッションにアクセス

モバイルアプリ

  • レスポンシブデザイン - すべての画面サイズに最適化
  • タッチフレンドリーインターフェース - スワイプジェスチャーとタッチナビゲーション
  • モバイルナビゲーション - 簡単な親指ナビゲーションのための下部タブバー
  • 適応レイアウト - 折りたたみ可能なサイドバーとスマートコンテンツの優先順位付け
  • ホーム画面にショートカットを追加 - ホーム画面にショートカットを追加すると、アプリはPWAのように動作します

アーキテクチャ

システム概要

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   フロントエンド   │    │   バックエンド    │    │  Gemini CLI     │
│   (React/Vite)  │◄──►│ (Express/WS)    │◄──►│  統合           │
└─────────────────┘    └─────────────────┘    └─────────────────┘

バックエンド（Node.js + Express）

  • Expressサーバー - 静的ファイルサービングを備えたRESTful API（ポート: 4008）
  • WebSocketサーバー - チャットとプロジェクト更新のための通信
  • Gemini CLI統合 - プロセスの生成と管理
  • セッション管理 - JSONLパースと会話の永続化
  • ファイルシステムAPI - プロジェクト用のファイルブラウザーを公開
  • 認証システム - セキュアなログインとセッション管理（SQLiteデータベース: geminicliui_auth.db）

フロントエンド（React + Vite）

  • React 18 - フックを使用したモダンなコンポーネントアーキテクチャ
  • CodeMirror - シンタックスハイライト付きの高度なコードエディター
  • Tailwind CSS - ユーティリティファーストのCSSフレームワーク
  • レスポンシブデザイン - モバイルファーストのアプローチ

設定詳細

ポート設定

  • APIサーバー: 4008番ポート（デフォルト）
  • フロントエンド開発サーバー: 4009番ポート（デフォルト）
  • これらのポートは.envファイルで変更可能です

データベース設定

初期設定とテーブル構造

  • データベースファイル: server/database/geminicliui_auth.db
  • データベースタイプ: SQLite 3
  • 初期化: サーバー起動時に自動的に作成・初期化されます

ユーザーテーブル詳細

テーブル名: geminicliui_users

カラム名 データ型 制約 説明
id INTEGER PRIMARY KEY AUTOINCREMENT ユーザーの一意識別子
username TEXT UNIQUE NOT NULL ログインユーザー名（メールアドレス推奨）
password_hash TEXT NOT NULL bcryptでハッシュ化されたパスワード
created_at DATETIME DEFAULT CURRENT_TIMESTAMP アカウント作成日時
last_login DATETIME NULL 最終ログイン日時
is_active BOOLEAN DEFAULT 1 アカウントの有効/無効状態

インデックス:

  • idx_geminicliui_users_username: ユーザー名での高速検索用
  • idx_geminicliui_users_active: アクティブユーザーのフィルタリング用

初回起動時の設定

  1. サーバー初回起動時、データベースファイルが存在しない場合は自動作成
  2. server/database/init.sql からテーブル構造を読み込み
  3. 初回アクセス時にユーザー登録画面が表示される
  4. 最初のユーザーが管理者として登録される

セキュリティ機能

  • パスワードは bcrypt でハッシュ化して保存
  • JWT トークンベースの認証システム
  • セッション管理とタイムアウト機能
  • SQLインジェクション対策（プリペアドステートメント使用）

トラブルシューティング

よくある問題と解決策

"Geminiプロジェクトが見つかりません"

問題: UIにプロジェクトが表示されない、またはプロジェクトリストが空 解決策:

  • Gemini CLIが適切にインストールされていることを確認
  • 少なくとも1つのプロジェクトディレクトリでgeminiコマンドを実行して初期化
  • ~/.gemini/projects/ディレクトリが存在し、適切な権限があることを確認

ファイルエクスプローラーの問題

問題: ファイルが読み込まれない、権限エラー、空のディレクトリ 解決策:

  • プロジェクトディレクトリの権限を確認（ターミナルでls -la）
  • プロジェクトパスが存在し、アクセス可能であることを確認
  • 詳細なエラーメッセージについてサーバーコンソールログを確認
  • プロジェクトスコープ外のシステムディレクトリにアクセスしようとしていないか確認

モデル選択が機能しない

問題: 選択したモデルが使用されない 解決策:

  • 設定でモデルを選択後、必ず「設定を保存」をクリック
  • ブラウザのローカルストレージをクリアして再度設定
  • チャット画面でモデル名が正しく表示されているか確認

ライセンス

GNU General Public License v3.0 - 詳細はLICENSEファイルを参照してください。

このプロジェクトはオープンソースであり、GPL v3ライセンスの下で自由に使用、変更、配布できます。

オリジナルプロジェクト

このプロジェクトはClaude Code UI (GPL v3.0)をベースにカスタマイズしています。

主な変更点:

  • Claude CLIからGemini CLIへの対応変更
  • 認証システムの追加（SQLiteベース）
  • Gemini専用のモデル選択機能
  • 日本語対応の強化
  • UIの調整とGeminiブランディング

オリジナルのClaude Code UIプロジェクトに感謝します。

謝辞

使用技術

  • Gemini CLI - Googleの公式CLI
  • React - ユーザーインターフェースライブラリ
  • Vite - 高速ビルドツールと開発サーバー
  • Tailwind CSS - ユーティリティファーストのCSSフレームワーク
  • CodeMirror - 高度なコードエディター

サポートとコミュニティ

最新情報を入手

  • このリポジトリにスターを付けてサポートを表明
  • アップデートと新リリースをウォッチ
  • アナウンスのためにプロジェクトをフォロー