Install
$ agentstack add mcp-piebald-ai-gemini-cli-desktop ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ● Network access Used
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →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.
Use with Gemini CLI:
Use with Qwen Code:
Quick Start
Download pre-built releases: GitHub 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 justorasdf plugin add just && asdf install just latest - Ubuntu:
snap install --edge --classic just - Windows:
winget install --id Casey.Just
Linux system dependencies (Ubuntu/Debian):
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
# 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:
Build & Run:
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.
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
- Source: Piebald-AI/gemini-cli-desktop
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.