Skip to content
Back to search

gemini-cli-desktop

SkillWorks with Gemini CLIGitHub

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/piebald-ai--gemini-cli-desktop/badge.svg)](/listings/piebald-ai--gemini-cli-desktop)

HTML

<a href="/listings/piebald-ai--gemini-cli-desktop"><img src="/api/listings/piebald-ai--gemini-cli-desktop/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 163 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div>
  2. <div align="right">
  3. <a href="https://piebald.ai"><img width="200" top="20" align="right" src="https://github.com/Piebald-AI/.github/raw/main/Wordmark.svg"></a>
  4. </div>
  5. <div align="left">
  6. ### Check out Piebald
  7. We've released **Piebald**, the ultimate agentic AI developer experience. \
  8. Download it and try it out for free! **https://piebald.ai/**
  9. <a href="https://piebald.ai/discord"><img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=flat&logo=discord&logoColor=white" alt="Join our Discord"></a>
  10. <a href="https://x.com/PiebaldAI"><img src="https://img.shields.io/badge/Follow%20%40PiebaldAI-000000?style=flat&logo=x&logoColor=white" alt="X"></a>
  11. <sub>[**Scroll down for Gemini CLI Desktop.**](#gemini-cli-desktop) :point_down:</sub>
  12. </div>
  13. </div>
  14. <div align="left">
  15. <a href="https://piebald.ai">
  16. <picture>
  17. <source media="(prefers-color-scheme: dark)" srcset="https://piebald.ai/screenshot-dark.png">
  18. <source media="(prefers-color-scheme: light)" srcset="https://piebald.ai/screenshot-light.png">
  19. <img alt="hero" width="800" src="https://piebald.ai/screenshot-light.png">
  20. </picture>
  21. </a>
  22. </div>
  23. # Gemini CLI Desktop
  24. [![CI](https://github.com/Piebald-AI/gemini-cli-desktop/workflows/CI/badge.svg)](https://github.com/Piebald-AI/gemini-cli-desktop/actions)
  25. [![Release & Publish](https://github.com/Piebald-AI/gemini-cli-desktop/workflows/Release%20%26%20Publish/badge.svg)](https://github.com/Piebald-AI/gemini-cli-desktop/actions)
  26. [![GitHub all releases](https://img.shields.io/github/downloads/Piebald-AI/gemini-cli-desktop/total)](https://github.com/Piebald-AI/gemini-cli-desktop/releases)
  27. [![GitHub release](https://img.shields.io/github/v/release/Piebald-AI/gemini-cli-desktop)](https://github.com/Piebald-AI/gemini-cli-desktop/releases)
  28. [![Mentioned in Awesome Gemini CLI](https://awesome.re/mentioned-badge.svg)](https://github.com/Piebald-AI/awesome-gemini-cli)
  29. [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)](https://github.com/Piebald-AI/gemini-cli-desktop/releases)
  30. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  31. [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri-FFC131)](https://tauri.app/)
  32. 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 [<img src="https://github.com/Piebald-AI/piebald-issues/raw/main/assets/logo.svg" width="15"> **Piebald.**](https://piebald.ai/)
  33. Use with **Gemini CLI:**
  34. <img alt="Screenshot of Gemini CLI Desktop" src="./assets/screenshot.png" width="600">
  35. Use with **Qwen Code:**
  36. <img alt="Screenshot of Gemini CLI Desktop for Qwen Code" src="./assets/qwen-desktop.png" width="600">
  37. ## Quick Start
  38. **Download pre-built releases:** [GitHub Releases](https://github.com/Piebald-AI/gemini-cli-desktop/releases)
  39. **Available builds:**
  40. - Windows (x64)
  41. - macOS (Intel & Apple Silicon)
  42. - Linux (x64 AppImage)
  43. ## Features
  44. - **Multi-model support** - Gemini 3 Pro/Flash, Gemini 2.5 Pro/Flash, Qwen Code, custom OpenAI providers
  45. - **Visual tool confirmation** - Review and approve AI actions before execution
  46. - **Real-time thought process** - Watch AI reasoning unfold
  47. - **Code diff viewer** - Clear visualization of proposed changes
  48. - **Chat history & search** - Automatic saving with full-text search
  49. - **Cross-platform** - Desktop app and web interface
  50. - **File @-mentions** - Reference files directly in conversations
  51. - **MCP server integration** - Model Context Protocol support
  52. - **Multi-language UI** - English, Chinese (Simplified & Traditional), Russian
  53. ## Development & Building
  54. ### Prerequisites & Dependencies
  55. **Install the `just` task runner:**
  56. - **macOS/Linux:** `cargo install just` or `asdf plugin add just && asdf install just latest`
  57. - **Ubuntu:** `snap install --edge --classic just`
  58. - **Windows:** `winget install --id Casey.Just`
  59. **Linux system dependencies (Ubuntu/Debian):**
  60. ```bash
  61. sudo apt install libgdk-pixbuf-2.0-dev libpango1.0-dev \
  62. libjavascriptcoregtk-4.1-dev libatk1.0-dev libsoup-3.0-dev \
  63. libwebkit2gtk-4.1-dev librsvg2-dev
  64. ```
  65. ### Development Workflow
  66. ```bash
  67. # Install dependencies and start desktop development with hot reload.
  68. just deps dev
  69. # Start web development with separate backend (port 1858) and frontend (port 1420) servers
  70. just deps dev-web
  71. # Build both desktop app installer (AppImage, DMG, MSI) and web server binaries for production.
  72. just build-all
  73. # Run the full test suite with nextest.
  74. just test
  75. # Run code linting and formatting checks (ESLint + Clippy).
  76. just lint
  77. ```
  78. **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.
  79. ### Build from Source
  80. **Prerequisites:**
  81. - [Rust](https://rust-lang.org)
  82. - [Node.js](https://nodejs.org)
  83. - [pnpm](https://pnpm.io)
  84. - [just](https://just.systems)
  85. **Build & Run:**
  86. ```bash
  87. git clone https://github.com/Piebald-AI/gemini-cli-desktop
  88. cd gemini-cli-desktop
  89. just deps build-all
  90. # Desktop app
  91. ./target/release/gemini-cli-desktop
  92. # Web server (access at http://localhost:1858)
  93. ./target/release/gemini-cli-desktop-web
  94. ```
  95. ### Release Process
  96. Releases are automatically built and published via GitHub Actions when version tags are pushed.
  97. ## Architecture
  98. - **Backend:** Rust with Tauri for desktop, Rocket for web server
  99. - **Frontend:** React + TypeScript with Tailwind CSS
  100. - **Protocols:** Agent Communication Protocol (ACP), WebSocket events
  101. - **Security:** Command filtering, tool confirmation workflows
  102. ## Roadmap
  103. - Token/cost tracking
  104. - Multi-modal support (images, audio)
  105. - Extension system
  106. - LLxprt integration
  107. ## Contributing
  108. Contributions are welcome! Please see the [contributing guide](CONTRIBUTING.md) for more details.
  109. ## License
  110. [MIT](./LICENSE)
  111. Copyright © 2026 [Piebald LLC.](https://piebald.ai)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.