Claudia – Desktop Companion for Claude Code

Claudia is a powerful desktop application that transforms how you interact with Claude Code. Built with Tauri 2, it provides a beautiful GUI for managing your Claude Code sessions, creating custom agents, tracking usage, and much more.

Think of Claudia as your command center for Claude Code - bridging the gap between the command-line tool and a visual experience that makes AI-assisted development more intuitive and productive.

• 🌟 Overview
• ✨ Features

  • 🗂️ Project & Session Management

  • 🤖 CC Agents

  • 📊 Usage Analytics Dashboard

  • 🔌 MCP Server Management

  • ⏰ Timeline & Checkpoints

  • 📝 CLAUDE.md Management

• 📖 Usage
  • Getting Started
  • Managing Projects
  • Creating Agents
  • Tracking Usage
  • Working with MCP Servers
• 🚀 Installation
• 🔨 Build from Source
• 🛠️ Development
• 🔒 Security
• 🤝 Contributing
• 📄 License
• 🙏 Acknowledgments

• Visual Project Browser: Navigate through all your Claude Code projects in ~/.claude/projects/
• Session History: View and resume past coding sessions with full context
• Smart Search: Find projects and sessions quickly with built-in search
• Session Insights: See first messages, timestamps, and session metadata at a glance

• Custom AI Agents: Create specialized agents with custom system prompts and behaviors
• Agent Library: Build a collection of purpose-built agents for different tasks
• Background Execution: Run agents in separate processes for non-blocking operations
• Execution History: Track all agent runs with detailed logs and performance metrics

• Cost Tracking: Monitor your Claude API usage and costs in real-time
• Token Analytics: Detailed breakdown by model, project, and time period
• Visual Charts: Beautiful charts showing usage trends and patterns
• Export Data: Export usage data for accounting and analysis

• Server Registry: Manage Model Context Protocol servers from a central UI
• Easy Configuration: Add servers via UI or import from existing configs
• Connection Testing: Verify server connectivity before use
• Claude Desktop Import: Import server configurations from Claude Desktop

• Session Versioning: Create checkpoints at any point in your coding session
• Visual Timeline: Navigate through your session history with a branching timeline
• Instant Restore: Jump back to any checkpoint with one click
• Fork Sessions: Create new branches from existing checkpoints
• Diff Viewer: See exactly what changed between checkpoints

• Built-in Editor: Edit CLAUDE.md files directly within the app
• Live Preview: See your markdown rendered in real-time
• Project Scanner: Find all CLAUDE.md files in your projects
• Syntax Highlighting: Full markdown support with syntax highlighting

1. Launch Claudia: Open the application after installation
2. Welcome Screen: Choose between CC Agents or CC Projects
3. First Time Setup: Claudia will automatically detect your ~/.claude directory

• Click on any project to view its sessions
• Each session shows the first message and timestamp
• Resume sessions directly or start new ones

1. Design Your Agent: Set name, icon, and system prompt
2. Configure Model: Choose between available Claude models
3. Set Permissions: Configure file read/write and network access
4. Execute Tasks: Run your agent on any project

• Monitor costs by model, project, and date
• Export data for reports
• Set up usage alerts (coming soon)

• Add servers manually or via JSON
• Import from Claude Desktop configuration
• Test connections before using

• Claude Code CLI: Install from Claude's official site

Before building Claudia from source, ensure you have the following installed:

• Operating System: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
• RAM: Minimum 4GB (8GB recommended)
• Storage: At least 1GB free space

1. Rust (1.70.0 or later)

   # Install via rustup curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Bun (latest version)

   # Install bun curl -fsSL https://bun.sh/install | bash

3. Git

   # Usually pre-installed, but if not: # Ubuntu/Debian: sudo apt install git # macOS: brew install git # Windows: Download from https://git-scm.com

4. Claude Code CLI

   • Download and install from Claude's official site
   • Ensure claude is available in your PATH

Linux (Ubuntu/Debian)

macOS

Windows

• Install Microsoft C++ Build Tools
• Install WebView2 (usually pre-installed on Windows 11)

1. Clone the Repository

   git clone https://github.com/getAsterisk/claudia.git cd claudia

2. Install Frontend Dependencies

3. Build the Application

   For Development (with hot reload)

   For Production Build

   # Build the application bun run tauri build # The built executable will be in: # - Linux: src-tauri/target/release/bundle/ # - macOS: src-tauri/target/release/bundle/ # - Windows: src-tauri/target/release/bundle/

4. Platform-Specific Build Options

   Debug Build (faster compilation, larger binary)

   bun run tauri build --debug

   Build without bundling (creates just the executable)

   bun run tauri build --no-bundle

   Universal Binary for macOS (Intel + Apple Silicon)

   bun run tauri build --target universal-apple-darwin

1. "cargo not found" error

   • Ensure Rust is installed and ~/.cargo/bin is in your PATH
   • Run source ~/.cargo/env or restart your terminal

2. Linux: "webkit2gtk not found" error

   • Install the webkit2gtk development packages listed above
   • On newer Ubuntu versions, you might need libwebkit2gtk-4.0-dev

3. Windows: "MSVC not found" error

   • Install Visual Studio Build Tools with C++ support
   • Restart your terminal after installation

4. "claude command not found" error

   • Ensure Claude Code CLI is installed and in your PATH
   • Test with claude --version

5. Build fails with "out of memory"

   • Try building with fewer parallel jobs: cargo build -j 2
   • Close other applications to free up RAM

After building, you can verify the application works:

The build process creates several artifacts:

• Executable: The main Claudia application
• Installers (when using tauri build):
  • .deb package (Linux)
  • .AppImage (Linux)
  • .dmg installer (macOS)
  • .msi installer (Windows)
  • .exe installer (Windows)

All artifacts are located in src-tauri/target/release/bundle/.

• Frontend: React 18 + TypeScript + Vite 6
• Backend: Rust with Tauri 2
• UI Framework: Tailwind CSS v4 + shadcn/ui
• Database: SQLite (via rusqlite)
• Package Manager: Bun

Claudia prioritizes your privacy and security:

1. Process Isolation: Agents run in separate processes
2. Permission Control: Configure file and network access per agent
3. Local Storage: All data stays on your machine
4. No Telemetry: No data collection or tracking
5. Open Source: Full transparency through open source code

We welcome contributions! Please see our Contributing Guide for details.

• 🐛 Bug fixes and improvements
• ✨ New features and enhancements
• 📚 Documentation improvements
• 🎨 UI/UX enhancements
• 🧪 Test coverage
• 🌐 Internationalization

This project is licensed under the AGPL License - see the LICENSE file for details.

• Built with Tauri - The secure framework for building desktop apps
• Claude by Anthropic