docs: add gemini cli install and session browser support

Author: ymkiux

README.md

@@ -29,7 +29,7 @@ Codex Mate is a local-first CLI + Web UI for unified management of:
 - Claude Code `CLAUDE.md` editing (writes to `~/.claude/CLAUDE.md`)
 - OpenClaw JSON5 profiles and workspace `AGENTS.md`
 - Local skills market for Codex / Claude Code (target switching, local skills management, cross-app import, ZIP distribution)
-- Local Codex/Claude sessions (list/filter/export/delete) with Usage analytics overview
+- Local Codex/Claude/Gemini CLI sessions (list/filter/export/delete) with Usage analytics overview
 - Plugins (Prompt templates): reusable templates with variables and one-click copy
 - Task orchestration: plan/queue/run/review local tasks
 
@@ -57,7 +57,7 @@ It works on local files directly and does not require cloud hosting. The skills
 - OpenClaw JSON5 profile management
 
 **Session Management**
-- Unified Codex + Claude session list
+- Unified Codex + Claude + Gemini CLI session list
 - Local session pinning with persistent pinned state and pinned-first ordering
 - Keyword/source/cwd filters
 - Fast search UX: short-lived query result caching to avoid rescanning on each keystroke
@@ -176,6 +176,9 @@ npm install -g @mmmbuto/codex-cli-termux@latest
 
 # Claude Code
 npm install -g @anthropic-ai/claude-code
+
+# Gemini CLI
+npm install -g @google/gemini-cli
 ```
 
 ### Run from source

README.zh.md

@@ -29,7 +29,7 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - Claude Code `CLAUDE.md` 编辑（写入 `~/.claude/CLAUDE.md`）
 - OpenClaw JSON5 配置与 Workspace `AGENTS.md`
 - Codex / Claude Code Skills 市场（安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发）
-- Codex / Claude 本地会话浏览、筛选、导出、删除与 Usage 统计概览
+- Codex / Claude / Gemini CLI 本地会话浏览、筛选、导出、删除与 Usage 统计概览
 - 插件（提示词模板）：模板复用、变量填写、一键复制
 - 任务编排：规划 / 排队 / 执行 / 回看
 
@@ -58,7 +58,7 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - OpenClaw JSON5 配置方案管理
 
 **会话管理**
-- 同页查看 Codex 与 Claude 会话
+- 同页查看 Codex、Claude 与 Gemini CLI 会话
 - 支持本地会话置顶，置顶状态持久化保存并优先排序显示
 - 关键词搜索、来源筛选、cwd 路径筛选
 - 搜索体验优化：短周期结果缓存，避免输入时重复扫描
@@ -166,7 +166,7 @@ codexmate run
 
 > 安全提示：默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理，请仅在可信网络中使用；如需仅本机访问，可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
 
-### 安装 Codex CLI / Claude Code（可选）
+### 安装 Codex CLI / Claude Code / Gemini CLI（可选）
 
 Codex Mate 支持透传调用官方 CLI（例如 `codexmate codex ...`），建议先安装：
 
@@ -179,6 +179,9 @@ npm install -g @mmmbuto/codex-cli-termux@latest
 
 # Claude Code
 npm install -g @anthropic-ai/claude-code
+
+# Gemini CLI
+npm install -g @google/gemini-cli
 ```
 
 ### 从源码运行

cli.js

@@ -274,6 +274,12 @@ const CLI_INSTALL_TARGETS = Object.freeze([
         packageName: '@anthropic-ai/claude-code',
         bins: ['claude']
     },
+    {
+        id: 'gemini',
+        name: 'Gemini CLI',
+        packageName: '@google/gemini-cli',
+        bins: ['gemini']
+    },
     {
         id: 'codex',
         name: 'Codex CLI',

site/guide/getting-started.md

@@ -13,6 +13,21 @@
 npm install -g codexmate
 ```
 
+### 安装官方 CLI（可选）
+
+Codex Mate 支持透传调用官方 CLI（例如 `codexmate codex ...`），并可在 Web UI 中浏览本地会话。建议先安装：
+
+```bash
+# Codex CLI
+npm install -g @openai/codex
+
+# Claude Code
+npm install -g @anthropic-ai/claude-code
+
+# Gemini CLI
+npm install -g @google/gemini-cli
+```
+
 ### 免安装试用
 
 ```bash
@@ -48,7 +63,7 @@ codexmate claude <BaseURL> <API_KEY> [model]
 codexmate auth <list|import|switch|delete|status>
 codexmate workflow <list|get|validate|run|runs>
 codexmate qwen [args...]
-codexmate export-session --source <codex|claude> --session-id <ID>
+codexmate export-session --source <codex|claude|gemini> --session-id <ID>
 ```
 
 ## 校验建议

site/index.md

@@ -34,7 +34,7 @@ Codex Mate 是一个本地优先的配置与会话管理工具，覆盖：
 - Codex provider/model 切换与配置写入
 - Claude Code 配置方案管理（写入 `~/.claude/settings.json`）
 - OpenClaw JSON5 配置与 Workspace `AGENTS.md`
-- Codex / Claude 本地会话浏览、导出、删除
+- Codex / Claude / Gemini CLI 本地会话浏览、导出、删除
 
 ## 快速开始
 
@@ -86,7 +86,7 @@ codexmate run --no-browser
 
 ### 会话
 
-- Codex + Claude 会话统一视图
+- Codex + Claude + Gemini CLI 会话统一视图
 - 搜索、筛选、导出、删除、批量清理
 
 ## 测试约定

web-ui/modules/app.methods.install.mjs

@@ -104,6 +104,11 @@ export function createInstallMethods() {
                     update: '',
                     uninstall: ''
                 },
+                gemini: {
+                    install: '',
+                    update: '',
+                    uninstall: ''
+                },
                 codex: {
                     install: '',
                     update: '',
@@ -114,6 +119,9 @@ export function createInstallMethods() {
                 matrix.claude.install = 'pnpm add -g @anthropic-ai/claude-code';
                 matrix.claude.update = 'pnpm up -g @anthropic-ai/claude-code';
                 matrix.claude.uninstall = 'pnpm remove -g @anthropic-ai/claude-code';
+                matrix.gemini.install = 'pnpm add -g @google/gemini-cli';
+                matrix.gemini.update = 'pnpm up -g @google/gemini-cli';
+                matrix.gemini.uninstall = 'pnpm remove -g @google/gemini-cli';
                 matrix.codex.install = `pnpm add -g ${codexInstallPackage}`;
                 matrix.codex.update = `pnpm up -g ${codexPackage}`;
                 matrix.codex.uninstall = `pnpm remove -g ${codexPackage}`;
@@ -123,6 +131,9 @@ export function createInstallMethods() {
                 matrix.claude.install = 'bun add -g @anthropic-ai/claude-code';
                 matrix.claude.update = 'bun update -g @anthropic-ai/claude-code';
                 matrix.claude.uninstall = 'bun remove -g @anthropic-ai/claude-code';
+                matrix.gemini.install = 'bun add -g @google/gemini-cli';
+                matrix.gemini.update = 'bun update -g @google/gemini-cli';
+                matrix.gemini.uninstall = 'bun remove -g @google/gemini-cli';
                 matrix.codex.install = `bun add -g ${codexInstallPackage}`;
                 matrix.codex.update = `bun update -g ${codexPackage}`;
                 matrix.codex.uninstall = `bun remove -g ${codexPackage}`;
@@ -131,6 +142,9 @@ export function createInstallMethods() {
             matrix.claude.install = 'npm install -g @anthropic-ai/claude-code';
             matrix.claude.update = 'npm update -g @anthropic-ai/claude-code';
             matrix.claude.uninstall = 'npm uninstall -g @anthropic-ai/claude-code';
+            matrix.gemini.install = 'npm install -g @google/gemini-cli';
+            matrix.gemini.update = 'npm update -g @google/gemini-cli';
+            matrix.gemini.uninstall = 'npm uninstall -g @google/gemini-cli';
             matrix.codex.install = `npm install -g ${codexInstallPackage}`;
             matrix.codex.update = platform === 'termux'
                 ? `npm install -g ${codexInstallPackage}`