https://github.com/piebald-ai/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 interface, locally or remotely.
https://github.com/piebald-ai/gemini-cli-desktop
agent-client-protocol agentic cross-platform desktop desktop-app development gemini gemini-api gemini-cli gemini-cli-ui gemini-cli-web gemini-desktop gemini-ui qwen qwen-code qwen3-coder tauri web webapp
Last synced: 3 months ago
JSON representation
Web/desktop UI for Gemini CLI/Qwen Code. Manage projects, switch between tools, search across past conversations, and manage MCP servers, all from one interface, locally or remotely.
- Host: GitHub
- URL: https://github.com/piebald-ai/gemini-cli-desktop
- Owner: Piebald-AI
- License: mit
- Created: 2025-07-27T14:52:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-09-28T21:38:38.000Z (3 months ago)
- Last Synced: 2025-09-28T22:19:27.413Z (3 months ago)
- Topics: agent-client-protocol, agentic, cross-platform, desktop, desktop-app, development, gemini, gemini-api, gemini-cli, gemini-cli-ui, gemini-cli-web, gemini-desktop, gemini-ui, qwen, qwen-code, qwen3-coder, tauri, web, webapp
- Language: TypeScript
- Homepage:
- Size: 3.48 MB
- Stars: 64
- Watchers: 2
- Forks: 5
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Gemini CLI Desktop
[](https://github.com/Piebald-AI/gemini-desktop/actions)
[](https://github.com/Piebald-AI/gemini-desktop/actions)
[](https://github.com/Piebald-AI/gemini-desktop/releases)
[](https://github.com/Piebald-AI/gemini-desktop/releases)
[](https://github.com/Piebald-AI/awesome-gemini-cli)
[](https://github.com/Piebald-AI/gemini-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.
Use with **Gemini CLI:**
Use with **Qwen Code:**
## Quick Start
**Download pre-built releases:** [GitHub Releases](https://github.com/Piebald-AI/gemini-desktop/releases)
**Available builds:**
- Windows (x64)
- macOS (Intel & Apple Silicon)
- Linux (x64 AppImage)
## Features
- **Multi-model support** - 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)
## 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-desktop
cd gemini-desktop
just deps build-all
# Desktop app
./target/release/gemini-desktop
# Web server (access at http://localhost:1858)
./target/release/gemini-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 © 2025 [Piebald LLC.](https://piebald.ai)