winget install --id=SureshJanakiReddy.GeminiDesktop -e A modern, blazing-fast native desktop application for interacting with the Gemini CLI via the Agent Client Protocol (ACP) over standard I/O (JSON-RPC). Built with Tauri v2, Rust, and SvelteKit.
A modern, blazing-fast native desktop application for interacting with the Gemini CLI via the Agent Client Protocol (ACP) over standard I/O (JSON-RPC). Built from the ground up with Tauri v2, Rust, and SvelteKit / Svelte 5.
⚡ Native Agent Client Protocol (ACP)
stdin/stdout.🎯 Official Gemini Model Selection
gemini-3.8-flash (latest preview — ultra-responsive next-gen Flash), gemini-3.5-flash (powerful default), gemini-3.5-flash-lite (lightweight), gemini-3.1-pro-preview, gemini-3.1-flash-lite, gemini-3-pro-preview, gemini-3-flash-preview.gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-flash-lite.🔌 Model Context Protocol (MCP) Server Integration (Ctrl+M)
/.gemini/settings.json) or Global (~/.gemini/settings.json).📎 File, Folder & Git Context Attachments
@ mention autocomplete popover with fuzzy search across workspace files and directories.@git:diff (working tree changes), @git:staged (index changes), and @git:status.🎨 Multi-Theme System & Syntax Highlighting
platinum-white).highlight.js syntax highlighting palette tuned for readable light and dark contrast.📁 Workspace & Directory Profiles
GEMINI.md context is automatically loaded).💬 Multi-Session Chat & History
🔍 Full-Text Search (SQLite FTS5)
📚 Reusable Prompt Templates
🖥️ Integrated Workspace Terminal Drawer (Ctrl+ `)
Ctrl+ ` or status toggle).↑/↓), clear commands (clear/cls), and quick-action shortcuts (git status, git diff --stat, dir).restart_gemini_session) to reload modified .env values into the AI session immediately.🌱 Workspace .env & .env.local Auto-Injection
.env and .env.local variables located in the active workspace root.🔒 Custom App Dialogs & Accessible Tooltips
alert, confirm, prompt) replacing webview-freezing browser popups.🛡️ Process Management & Safety
JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE).| Shortcut | Action | Scope |
|---|---|---|
Ctrl + ** / **Ctrl + ~` | Toggle Integrated Workspace Terminal Drawer | Global |
Ctrl + M | Toggle MCP Server Manager | Global |
Ctrl + K | Open Full-Text SQLite FTS5 Search | Global |
Ctrl + N | Start New Chat Session | Global |
@ | Trigger Context Mention Autocomplete (Files, Dirs, Git) | Prompt Textarea |
Enter | Send Prompt / Execute Terminal Command | Prompt / Terminal |
Shift + Enter | Insert Newline in Prompt | Prompt Textarea |
Esc | Close Open Modals / Autocomplete Popover | Global |
Pre-built Windows binaries are automatically generated on every release:
GeminiDesktop-Setup.exe: Standard Windows installer (NSIS).Gemini Desktop_x64_en-US.msi: Windows MSI installer.GeminiDesktop.exe: Portable standalone executable.gemini is installed and accessible in your system PATH.| Layer | Technology |
|---|---|
| Desktop Framework | Tauri v2 |
| Backend Language | Rust (2021 Edition) |
| Frontend Framework | SvelteKit 2 + Svelte 5 (Runes) |
| Language | TypeScript |
| Styling | Tailwind CSS v4 + Lucide Icons |
| Markdown & Syntax | marked, highlight.js |
| Database | Embedded SQLite with FTS5 via rusqlite |
v20 or latergit clone https://github.com/sureshjsreddy/gemini-desktop.git
cd gemini-desktop
# Install frontend dependencies
npm install
npm run tauri dev
This boots Vite with hot-module reloading on localhost:1420 and spawns the native Tauri desktop window.
# Type check Svelte & TypeScript
npm run check
# Run Rust unit tests
npm --prefix src-tauri test
# or
cargo test --manifest-path src-tauri/Cargo.toml
npm run tauri build
Compiled binaries and installers will be output to src-tauri/target/release/bundle/.
Automated builds and releases are managed via GitHub Actions (.github/workflows/release.yml):
v* (e.g. v0.1.0) triggers a build on windows-latest..exe and .msi installers to GitHub Releases.workflow_dispatch in the GitHub Actions tab.This project is licensed under the MIT License.