用 Gemini CLI 或 Qwen Code 写代码时，命令行里看工具调用、思考过程和代码改动全靠滚动文本，确实不够直观；历史对话也散落在终端里难以检索。Gemini CLI Desktop 给这套命令行套上桌面 / Web 界面：可视化确认工具调用、实时看推理、对比代码差异、检索历史会话，体验立刻不同。

项目基本信息

信息项详情
项目名称gemini-cli-desktop
GitHub地址https://github.com/Piebald-AI/gemini-cli-desktop
项目描述为Gemini CLI与Qwen Code打造的桌面/Web可视化界面，带工具确认与历史检索
作者Piebald-AI
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-24

一、项目介绍

Gemini CLI Desktop 是一个面向 Gemini CLI 与 Qwen Code 的桌面和 Web 界面，由 Rust 后端（Tauri / Rocket）加 React 前端构成。它提供可视化工具确认、实时思考过程、代码 diff 查看、聊天历史管理与全文检索、文件树浏览、文件 @ 引用、MCP 服务器集成，以及中英等多语言界面。支持 Windows(x64)、macOS(Intel/Apple Silicon)、Linux(x64 AppImage)。

二、核心优势

  • 多模型支持：Gemini 3 Pro/Flash、Gemini 2.5、Qwen Code 及自定义 OpenAI provider。
  • 可视化工具确认：执行前审查并批准 AI 动作。
  • 实时思考过程：看着 AI 推理逐步展开。
  • 代码 diff 查看：清晰呈现改动。
  • 跨平台：桌面应用 + Web 界面双形态。
  • MCP 集成与文件 @ 引用：扩展能力、上下文更准。

三、适用场景

  • 想用图形界面替代纯终端使用 Gemini CLI / Qwen Code。
  • 需要审阅 AI 工具调用再放行的安全敏感场景。
  • 跨会话检索历史、复用过往对话。
  • 团队统一本地或自托管 AI 编程前端。

四、安装教程

直接下载预编译包（推荐）：

 # 从 GitHub Releases 下载对应平台安装包
 # Windows(x64) / macOS(Intel & Apple Silicon) / Linux(x64 AppImage)

从源码构建依赖 Rust、Node.js、pnpm、just：

 git clone https://github.com/Piebald-AI/gemini-cli-desktop
 cd gemini-cli-desktop
 just deps build-all

常见报错：Linux 需先装 WebKit 等系统库（sudo apt install libwebkit2gtk-4.1-dev ...）；Windows 用 winget install --id Casey.Just 装 just。

五、使用示例

开发模式（前端 1420 + 后端 1858）：

 just deps dev-web

运行桌面应用：

 ./target/release/gemini-cli-desktop

输出：可视化界面中显示会话、工具确认弹窗、代码 diff 与历史搜索。

六、常见问题

  • 必须联网吗？连 Gemini / Qwen 需要；界面本身可本地运行。
  • 支持哪些模型？Gemini 系列、Qwen Code 及自定义 OpenAI 兼容端点。
  • 数据隐私？工具确认与本地历史均由你掌控，密钥走对应 CLI 配置。

七、总结

Gemini CLI Desktop 把命令行 AI 编程助手的体验从“纯文本”升级为“看得见、可审阅”，对重视可控性与可检索性的开发者很实用。MIT 协议，跨平台，适合想要图形化前端包裹 Gemini CLI / Qwen Code 的用户。