Claudia is a desktop application that provides a GUI for interacting with Claude Code, a command-line tool for AI-assisted development. It allows users to manage Claude Code projects and sessions, create custom AI agents with specific system prompts and behaviors, track API usage and costs, manage Model Context Protocol (MCP) servers, and utilize a timeline with checkpoints for session versioning. The target audience includes developers and power users who want a more intuitive and productive visual experience for their AI-assisted coding workflows.

How It Works

Claudia is built with Tauri 2, leveraging Rust for the backend and React with TypeScript for the frontend. It interacts with the Claude Code CLI to manage projects and sessions. Key features include a visual project browser, session history, smart search, and session insights. Custom agents can be created with configurable system prompts, models, and permissions, running in separate processes for non-blocking operations. Usage analytics are presented through real-time cost tracking, token analytics, and visual charts.

Quick Start & Requirements

• Installation: Release executables will be published soon. Currently, building from source is required.
• Prerequisites:
  • Claude Code CLI installed and available in PATH.
  • Rust (1.70.0 or later) installed via rustup.
  • Bun (latest version) installed.
  • Git installed.
  • Linux (Ubuntu/Debian): Install system dependencies including libwebkit2gtk-4.1-dev, libgtk-3-dev, librsvg2-dev, patchelf, build-essential, curl, wget, file, libssl-dev, libxdo-dev, libsoup-3.0-dev, libjavascriptcoregtk-4.1-dev.
  • macOS: Install Xcode Command Line Tools.
  • Windows: Install Microsoft C++ Build Tools and WebView2.
• Build from Source: Clone the repository, run bun install for frontend dependencies, and bun run tauri build for a production build.
• Links: GitHub Repository (Note: The provided README links to getAsterisk/gooey, but the content describes a project named "Claudia".)

Highlighted Details

• Project & Session Management: Visual project browser, session history, smart search, and session insights.
• CC Agents: Custom AI agents with custom system prompts, background execution, and execution history.
• Usage Analytics: Real-time cost tracking, token analytics, visual charts, and data export.
• Timeline & Checkpoints: Session versioning, visual timeline navigation, instant restore, and diff viewer.

Maintenance & Community

The project is maintained by getAsterisk. Further community and contribution details can be found in the Contributing Guide.

Licensing & Compatibility

• License: AGPL License.
• Compatibility: The AGPL license may have implications for closed-source linking due to its copyleft provisions.

Limitations & Caveats

Release executables are not yet published, requiring users to build from source. The project is actively under development, with features like usage alerts noted as "coming soon."