# Gemini Cli Desktop > Web/desktop UI for Gemini CLI/Qwen Code. Manage projects, switch between tools, search across past conversations, and manage MCP servers, all from one multilingual interface, locally or remotely. - **Type:** MCP server - **Install:** `agentstack add mcp-piebald-ai-gemini-cli-desktop` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Piebald-AI](https://agentstack.voostack.com/s/piebald-ai) - **Installs:** 0 - **Category:** [Search](https://agentstack.voostack.com/c/search) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Piebald-AI](https://github.com/Piebald-AI) - **Source:** https://github.com/Piebald-AI/gemini-cli-desktop ## Install ```sh agentstack add mcp-piebald-ai-gemini-cli-desktop ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About ### Check out Piebald We've released **Piebald**, the ultimate agentic AI developer experience. \ Download it and try it out for free! **https://piebald.ai/** [**Scroll down for Gemini CLI Desktop.**](#gemini-cli-desktop) :point_down: # Gemini CLI Desktop [](https://github.com/Piebald-AI/gemini-cli-desktop/actions) [](https://github.com/Piebald-AI/gemini-cli-desktop/actions) [](https://github.com/Piebald-AI/gemini-cli-desktop/releases) [](https://github.com/Piebald-AI/gemini-cli-desktop/releases) [](https://github.com/Piebald-AI/awesome-gemini-cli) [](https://github.com/Piebald-AI/gemini-cli-desktop/releases) [](https://opensource.org/licenses/MIT) [](https://tauri.app/) A powerful **desktop** and **web** interface for **Gemini CLI** and **Qwen Code** with visual tool confirmation, real-time thought processes, code diff viewing, chat history management & search, a file tree browser, and file @-mentions. Built with Rust and React for performance and reliability. From the team behind [ **Piebald.**](https://piebald.ai/) Use with **Gemini CLI:** Use with **Qwen Code:** ## Quick Start **Download pre-built releases:** [GitHub Releases](https://github.com/Piebald-AI/gemini-cli-desktop/releases) **Available builds:** - Windows (x64) - macOS (Intel & Apple Silicon) - Linux (x64 AppImage) ## Features - **Multi-model support** - Gemini 3 Pro/Flash, Gemini 2.5 Pro/Flash, Qwen Code, custom OpenAI providers - **Visual tool confirmation** - Review and approve AI actions before execution - **Real-time thought process** - Watch AI reasoning unfold - **Code diff viewer** - Clear visualization of proposed changes - **Chat history & search** - Automatic saving with full-text search - **Cross-platform** - Desktop app and web interface - **File @-mentions** - Reference files directly in conversations - **MCP server integration** - Model Context Protocol support - **Multi-language UI** - English, Chinese (Simplified & Traditional), Russian ## Development & Building ### Prerequisites & Dependencies **Install the `just` task runner:** - **macOS/Linux:** `cargo install just` or `asdf plugin add just && asdf install just latest` - **Ubuntu:** `snap install --edge --classic just` - **Windows:** `winget install --id Casey.Just` **Linux system dependencies (Ubuntu/Debian):** ```bash sudo apt install libgdk-pixbuf-2.0-dev libpango1.0-dev \ libjavascriptcoregtk-4.1-dev libatk1.0-dev libsoup-3.0-dev \ libwebkit2gtk-4.1-dev librsvg2-dev ``` ### Development Workflow ```bash # Install dependencies and start desktop development with hot reload. just deps dev # Start web development with separate backend (port 1858) and frontend (port 1420) servers just deps dev-web # Build both desktop app installer (AppImage, DMG, MSI) and web server binaries for production. just build-all # Run the full test suite with nextest. just test # Run code linting and formatting checks (ESLint + Clippy). just lint ``` **Note:** For the web version, development uses two separate ports: 1420 for the frontend and 1858 for the Rust + Rocket backend. In production, the backend server also hosts the static frontend files, so only port 1858 is used. ### Build from Source **Prerequisites:** - [Rust](https://rust-lang.org) - [Node.js](https://nodejs.org) - [pnpm](https://pnpm.io) - [just](https://just.systems) **Build & Run:** ```bash git clone https://github.com/Piebald-AI/gemini-cli-desktop cd gemini-cli-desktop just deps build-all # Desktop app ./target/release/gemini-cli-desktop # Web server (access at http://localhost:1858) ./target/release/gemini-cli-desktop-web ``` ### Release Process Releases are automatically built and published via GitHub Actions when version tags are pushed. ## Architecture - **Backend:** Rust with Tauri for desktop, Rocket for web server - **Frontend:** React + TypeScript with Tailwind CSS - **Protocols:** Agent Communication Protocol (ACP), WebSocket events - **Security:** Command filtering, tool confirmation workflows ## Roadmap - Token/cost tracking - Multi-modal support (images, audio) - Extension system - LLxprt integration ## Contributing Contributions are welcome! Please see the [contributing guide](CONTRIBUTING.md) for more details. ## License [MIT](./LICENSE) Copyright © 2026 [Piebald LLC.](https://piebald.ai) ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Piebald-AI](https://github.com/Piebald-AI) - **Source:** [Piebald-AI/gemini-cli-desktop](https://github.com/Piebald-AI/gemini-cli-desktop) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-piebald-ai-gemini-cli-desktop - Seller: https://agentstack.voostack.com/s/piebald-ai - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.