A cross-platform desktop GUI for Claude Code
Claudy is a local-first desktop application that wraps Claude Code in a modern graphical interface. It lets you manage multiple projects, track sessions, monitor usage, and interact with Claude through a rich chat UI — all without leaving your desktop.
- Open multiple projects in tabs, each with independent state
- Star/favorite projects for quick access
- Search, sort, and filter your project list
- Auto-discovered from your existing Claude Code sessions
- Real-time message streaming with thinking blocks, tool use, and tool results
- Markdown rendering with syntax-highlighted code blocks
- File reference badges with inline diffs
- Autocomplete for slash commands (
/compact,/model,/review, etc.) and file references (@file) - Interactive terminal sessions via integrated xterm.js
- Session pinning, renaming, and management
- Browse and install skills from a built-in catalog
- Install community skills from GitHub repositories or local folders
- Includes pre-configured skills: algorithmic art, frontend design, MCP builder, web artifacts, webapp testing, and more
- Model selection
- Per-session and global tool permission management
- MCP (Model Context Protocol) server configuration
- YOLO mode for rapid execution
- Persistent tab state across sessions
- Built-in auto-updater
- Track token usage and costs across sessions, models, and projects
- Daily usage charts (sessions, messages, tokens, cost)
- Model breakdown (input/output tokens, cost per model)
- Project breakdown (sessions, messages, file modifications, last activity)
- Filter by interval: 7 days, 30 days, 90 days, or all-time
- Claude Code must be installed and authenticated on your machine
- An active Anthropic account with a Claude Code subscription
Download the latest release for your platform from the Releases page.
| Platform | File |
|---|---|
| Windows x64 | .msi or .exe (NSIS installer) |
| macOS Apple Silicon | .dmg (aarch64) |
| macOS Intel | .dmg (x64) |
| Linux x64 | .deb or .AppImage |
- Download the
.msior.exeinstaller - Run the installer. Windows may show a SmartScreen warning since the app is unsigned
- Click "More info" then "Run anyway" to proceed
Since Claudy is not signed with an Apple Developer certificate, macOS will block it by default. To install:
-
Download the
.dmgfor your architecture (Apple Silicon or Intel) -
Open the
.dmgand drag Claudy to your Applications folder -
Do not double-click to open it yet. Instead, open Terminal and run:
xattr -cr /Applications/Claudy.app
-
Now open Claudy from your Applications folder normally
Why? macOS quarantines apps downloaded from the internet. The
xattr -crcommand removes the quarantine flag so Gatekeeper won't block the unsigned app.
If you skipped step 3 and see "Claudy is damaged and can't be opened" or "Apple cannot verify this app", run the xattr command above and try again.
sudo dpkg -i claudy_*.debchmod +x Claudy_*.AppImage
./Claudy_*.AppImage- Node.js 20+
- Rust (stable)
- Tauri CLI prerequisites for your platform
# Clone the repository
git clone https://github.com/andreizet/claudy.git
cd claudy
# Install dependencies
npm ci
# Run in development mode (with hot reload)
npm run tauri dev
# Build for production
npm run tauri buildBuild artifacts will be in src-tauri/target/release/bundle/.
npm test- Frontend: React 18, TypeScript, Mantine UI, Vite
- Backend: Rust, Tauri 2
- Terminal: xterm.js with PTY support
- State: TanStack React Query, localStorage persistence
Contributions are welcome! Here's how to get started:
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-feature) - Make your changes and add tests where appropriate
- Run
npm testand ensure everything passes - Commit your changes and push to your fork
- Open a Pull Request
Please open an issue first to discuss significant changes before submitting a PR.
See open issues for planned features and known bugs.
MIT © andreizet