Repository files navigation

Announcement: Piebald is released!

We've releasedPiebald, the ultimate agentic AI developer experience.
Download it and try it out for free!https://piebald.ai/

_{Scroll down for Gemini CLI Desktop. 👇}

A powerfuldesktop andweb interface forGemini CLI andQwen 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 behindPiebald.

Use withGemini CLI:

Use withQwen Code:

Download pre-built releases:GitHub Releases

Available builds:

• Windows (x64)
• macOS (Intel & Apple Silicon)
• Linux (x64 AppImage)

• 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)

Install thejust task runner:

• macOS/Linux:cargo install just orasdf 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

# Install dependencies and start desktop development with hot reload.just deps dev# Start web development with separate backend (port 1858) and frontend (port 1420) serversjust 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.justtest# 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.

Prerequisites:

• Rust
• Node.js
• pnpm
• just

Build & Run:

git clone https://github.com/Piebald-AI/gemini-cli-desktopcd gemini-cli-desktopjust deps build-all# Desktop app./target/release/gemini-cli-desktop# Web server (access at http://localhost:1858)./target/release/gemini-cli-desktop-web

Releases are automatically built and published via GitHub Actions when version tags are pushed.

• 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

• Token/cost tracking
• Multi-modal support (images, audio)
• Extension system
• LLxprt integration

Contributions are welcome! Please see thecontributing guide for more details.

MIT

Copyright © 2025Piebald LLC.