{"id":29104115,"url":"https://github.com/getAsterisk/claudia","last_synced_at":"2025-06-29T00:04:12.930Z","repository":{"id":300425574,"uuid":"1004995740","full_name":"getAsterisk/claudia","owner":"getAsterisk","description":"A powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.","archived":false,"fork":false,"pushed_at":"2025-06-21T15:46:26.000Z","size":859,"stargazers_count":970,"open_issues_count":15,"forks_count":71,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-21T16:34:40.993Z","etag":null,"topics":["anthropic","anthropic-claude","claude","claude-4","claude-4-opus","claude-4-sonnet","claude-ai","claude-code","claude-code-sdk","cursor","ide","llm","llm-code","rust","tauri"],"latest_commit_sha":null,"homepage":"https://claudia.asterisk.so","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getAsterisk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-19T13:53:26.000Z","updated_at":"2025-06-21T16:26:26.000Z","dependencies_parsed_at":"2025-06-21T16:45:08.615Z","dependency_job_id":null,"html_url":"https://github.com/getAsterisk/claudia","commit_stats":null,"previous_names":["getasterisk/claudia"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/getAsterisk/claudia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getAsterisk%2Fclaudia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getAsterisk%2Fclaudia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getAsterisk%2Fclaudia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getAsterisk%2Fclaudia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getAsterisk","download_url":"https://codeload.github.com/getAsterisk/claudia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getAsterisk%2Fclaudia/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261595784,"owners_count":23182249,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","anthropic-claude","claude","claude-4","claude-4-opus","claude-4-sonnet","claude-ai","claude-code","claude-code-sdk","cursor","ide","llm","llm-code","rust","tauri"],"created_at":"2025-06-29T00:02:06.284Z","updated_at":"2025-06-29T00:04:12.922Z","avatar_url":"https://github.com/getAsterisk.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Claude Code Ecosystem","HarmonyOS","A01_文本生成_文本对话","GUIs \u0026 Web UIs","Orchestration","代码 Coding","核心扩展与集成","Table of Contents"],"sub_categories":["Frameworks \u0026 Platforms","Windows Manager","大语言对话模型及数据","Agent"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/92fd93ed-e71b-4b94-b270-50684323dd00\" alt=\"Claudia Logo\" width=\"120\" height=\"120\"\u003e\n\n  \u003ch1\u003eClaudia\u003c/h1\u003e\n  \n  \u003cp\u003e\n    \u003cstrong\u003eA powerful GUI app and Toolkit for Claude Code\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eCreate custom agents, manage interactive Claude Code sessions, run secure background agents, and more.\u003c/strong\u003e\n  \u003c/p\u003e\n  \n  \u003cp\u003e\n    \u003ca href=\"#features\"\u003e\u003cimg src=\"https://img.shields.io/badge/Features-✨-blue?style=for-the-badge\" alt=\"Features\"\u003e\u003c/a\u003e\n    \u003ca href=\"#installation\"\u003e\u003cimg src=\"https://img.shields.io/badge/Install-🚀-green?style=for-the-badge\" alt=\"Installation\"\u003e\u003c/a\u003e\n    \u003ca href=\"#usage\"\u003e\u003cimg src=\"https://img.shields.io/badge/Usage-📖-purple?style=for-the-badge\" alt=\"Usage\"\u003e\u003c/a\u003e\n    \u003ca href=\"#development\"\u003e\u003cimg src=\"https://img.shields.io/badge/Develop-🛠️-orange?style=for-the-badge\" alt=\"Development\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n![457013521-6133a738-d0cb-4d3e-8746-c6768c82672c](https://github.com/user-attachments/assets/a028de9e-d881-44d8-bae5-7326ab3558b9)\n\nhttps://github.com/user-attachments/assets/bf0bdf9d-ba91-45af-9ac4-7274f57075cf\n\n\u003e [!TIP]\n\u003e **⭐ Star the repo and follow [@getAsterisk](https://x.com/getAsterisk) on X for early access to `asteria-swe-v0`**.\n\n## 🌟 Overview\n\n**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.\n\nThink 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.\n\n## 📋 Table of Contents\n\n- [🌟 Overview](#-overview)\n- [✨ Features](#-features)\n  - [🗂️ Project \u0026 Session Management](#️-project--session-management)\n  - [🤖 CC Agents](#-cc-agents)\n  - [🛡️ Advanced Sandboxing](#️-advanced-sandboxing)\n  - [📊 Usage Analytics Dashboard](#-usage-analytics-dashboard)\n  - [🔌 MCP Server Management](#-mcp-server-management)\n  - [⏰ Timeline \u0026 Checkpoints](#-timeline--checkpoints)\n  - [📝 CLAUDE.md Management](#-claudemd-management)\n- [📖 Usage](#-usage)\n  - [Getting Started](#getting-started)\n  - [Managing Projects](#managing-projects)\n  - [Creating Agents](#creating-agents)\n  - [Tracking Usage](#tracking-usage)\n  - [Working with MCP Servers](#working-with-mcp-servers)\n- [🚀 Installation](#-installation)\n- [🔨 Build from Source](#-build-from-source)\n- [🛠️ Development](#️-development)\n- [🔒 Security](#-security)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n- [🙏 Acknowledgments](#-acknowledgments)\n\n## ✨ Features\n\n### 🗂️ **Project \u0026 Session Management**\n- **Visual Project Browser**: Navigate through all your Claude Code projects in `~/.claude/projects/`\n- **Session History**: View and resume past coding sessions with full context\n- **Smart Search**: Find projects and sessions quickly with built-in search\n- **Session Insights**: See first messages, timestamps, and session metadata at a glance\n\n### 🤖 **CC Agents**\n- **Custom AI Agents**: Create specialized agents with custom system prompts and behaviors\n- **Agent Library**: Build a collection of purpose-built agents for different tasks\n- **Secure Execution**: Run agents in sandboxed environments with fine-grained permissions\n- **Execution History**: Track all agent runs with detailed logs and performance metrics\n\n### 🛡️ **Advanced Sandboxing**\n- **OS-Level Security**: Platform-specific sandboxing (seccomp on Linux, Seatbelt on macOS)\n- **Permission Profiles**: Create reusable security profiles with granular access controls\n- **Violation Tracking**: Monitor and log all security violations in real-time\n- **Import/Export**: Share sandbox profiles across teams and systems\n\n### 📊 **Usage Analytics Dashboard**\n- **Cost Tracking**: Monitor your Claude API usage and costs in real-time\n- **Token Analytics**: Detailed breakdown by model, project, and time period\n- **Visual Charts**: Beautiful charts showing usage trends and patterns\n- **Export Data**: Export usage data for accounting and analysis\n\n### 🔌 **MCP Server Management**\n- **Server Registry**: Manage Model Context Protocol servers from a central UI\n- **Easy Configuration**: Add servers via UI or import from existing configs\n- **Connection Testing**: Verify server connectivity before use\n- **Claude Desktop Import**: Import server configurations from Claude Desktop\n\n### ⏰ **Timeline \u0026 Checkpoints**\n- **Session Versioning**: Create checkpoints at any point in your coding session\n- **Visual Timeline**: Navigate through your session history with a branching timeline\n- **Instant Restore**: Jump back to any checkpoint with one click\n- **Fork Sessions**: Create new branches from existing checkpoints\n- **Diff Viewer**: See exactly what changed between checkpoints\n\n### 📝 **CLAUDE.md Management**\n- **Built-in Editor**: Edit CLAUDE.md files directly within the app\n- **Live Preview**: See your markdown rendered in real-time\n- **Project Scanner**: Find all CLAUDE.md files in your projects\n- **Syntax Highlighting**: Full markdown support with syntax highlighting\n\n## 📖 Usage\n\n### Getting Started\n\n1. **Launch Claudia**: Open the application after installation\n2. **Welcome Screen**: Choose between CC Agents or CC Projects\n3. **First Time Setup**: Claudia will automatically detect your `~/.claude` directory\n\n### Managing Projects\n\n```\nCC Projects → Select Project → View Sessions → Resume or Start New\n```\n\n- Click on any project to view its sessions\n- Each session shows the first message and timestamp\n- Resume sessions directly or start new ones\n\n### Creating Agents\n\n```\nCC Agents → Create Agent → Configure → Execute\n```\n\n1. **Design Your Agent**: Set name, icon, and system prompt\n2. **Configure Model**: Choose between available Claude models\n3. **Set Sandbox Profile**: Apply security restrictions\n4. **Execute Tasks**: Run your agent on any project\n\n### Tracking Usage\n\n```\nMenu → Usage Dashboard → View Analytics\n```\n\n- Monitor costs by model, project, and date\n- Export data for reports\n- Set up usage alerts (coming soon)\n\n### Working with MCP Servers\n\n```\nMenu → MCP Manager → Add Server → Configure\n```\n\n- Add servers manually or via JSON\n- Import from Claude Desktop configuration\n- Test connections before using\n\n## 🚀 Installation\n\n### Prerequisites\n\n- **Claude Code CLI**: Install from [Claude's official site](https://claude.ai/code)\n\n### Release Executables Will Be Published Soon\n\n## 🔨 Build from Source\n\n### Prerequisites\n\nBefore building Claudia from source, ensure you have the following installed:\n\n#### System Requirements\n\n- **Operating System**: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)\n- **RAM**: Minimum 4GB (8GB recommended)\n- **Storage**: At least 1GB free space\n\n#### Required Tools\n\n1. **Rust** (1.70.0 or later)\n   ```bash\n   # Install via rustup\n   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n   ```\n\n2. **Bun** (latest version)\n   ```bash\n   # Install bun\n   curl -fsSL https://bun.sh/install | bash\n   ```\n\n3. **Git**\n   ```bash\n   # Usually pre-installed, but if not:\n   # Ubuntu/Debian: sudo apt install git\n   # macOS: brew install git\n   # Windows: Download from https://git-scm.com\n   ```\n\n4. **Claude Code CLI**\n   - Download and install from [Claude's official site](https://claude.ai/code)\n   - Ensure `claude` is available in your PATH\n\n#### Platform-Specific Dependencies\n\n**Linux (Ubuntu/Debian)**\n```bash\n# Install system dependencies\nsudo apt update\nsudo apt install -y \\\n  libwebkit2gtk-4.1-dev \\\n  libgtk-3-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  patchelf \\\n  build-essential \\\n  curl \\\n  wget \\\n  file \\\n  libssl-dev \\\n  libxdo-dev \\\n  libsoup-3.0-dev \\\n  libjavascriptcoregtk-4.1-dev\n```\n\n**macOS**\n```bash\n# Install Xcode Command Line Tools\nxcode-select --install\n\n# Install additional dependencies via Homebrew (optional)\nbrew install pkg-config\n```\n\n**Windows**\n- Install [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)\n- Install [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/) (usually pre-installed on Windows 11)\n\n### Build Steps\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/getAsterisk/claudia.git\n   cd claudia\n   ```\n\n2. **Install Frontend Dependencies**\n   ```bash\n   bun install\n   ```\n\n3. **Build the Application**\n   \n   **For Development (with hot reload)**\n   ```bash\n   bun run tauri dev\n   ```\n   \n   **For Production Build**\n   ```bash\n   # Build the application\n   bun run tauri build\n   \n   # The built executable will be in:\n   # - Linux: src-tauri/target/release/bundle/\n   # - macOS: src-tauri/target/release/bundle/\n   # - Windows: src-tauri/target/release/bundle/\n   ```\n\n4. **Platform-Specific Build Options**\n   \n   **Debug Build (faster compilation, larger binary)**\n   ```bash\n   bun run tauri build --debug\n   ```\n   \n   **Build without bundling (creates just the executable)**\n   ```bash\n   bun run tauri build --no-bundle\n   ```\n   \n   **Universal Binary for macOS (Intel + Apple Silicon)**\n   ```bash\n   bun run tauri build --target universal-apple-darwin\n   ```\n\n### Troubleshooting\n\n#### Common Issues\n\n1. **\"cargo not found\" error**\n   - Ensure Rust is installed and `~/.cargo/bin` is in your PATH\n   - Run `source ~/.cargo/env` or restart your terminal\n\n2. **Linux: \"webkit2gtk not found\" error**\n   - Install the webkit2gtk development packages listed above\n   - On newer Ubuntu versions, you might need `libwebkit2gtk-4.0-dev`\n\n3. **Windows: \"MSVC not found\" error**\n   - Install Visual Studio Build Tools with C++ support\n   - Restart your terminal after installation\n\n4. **\"claude command not found\" error**\n   - Ensure Claude Code CLI is installed and in your PATH\n   - Test with `claude --version`\n\n5. **Build fails with \"out of memory\"**\n   - Try building with fewer parallel jobs: `cargo build -j 2`\n   - Close other applications to free up RAM\n\n#### Verify Your Build\n\nAfter building, you can verify the application works:\n\n```bash\n# Run the built executable directly\n# Linux/macOS\n./src-tauri/target/release/claudia\n\n# Windows\n./src-tauri/target/release/claudia.exe\n```\n\n### Build Artifacts\n\nThe build process creates several artifacts:\n\n- **Executable**: The main Claudia application\n- **Installers** (when using `tauri build`):\n  - `.deb` package (Linux)\n  - `.AppImage` (Linux)\n  - `.dmg` installer (macOS)\n  - `.msi` installer (Windows)\n  - `.exe` installer (Windows)\n\nAll artifacts are located in `src-tauri/target/release/bundle/`.\n\n## 🛠️ Development\n\n### Tech Stack\n\n- **Frontend**: React 18 + TypeScript + Vite 6\n- **Backend**: Rust with Tauri 2\n- **UI Framework**: Tailwind CSS v4 + shadcn/ui\n- **Database**: SQLite (via rusqlite)\n- **Package Manager**: Bun\n\n### Project Structure\n\n```\nclaudia/\n├── src/                   # React frontend\n│   ├── components/        # UI components\n│   ├── lib/               # API client \u0026 utilities\n│   └── assets/            # Static assets\n├── src-tauri/             # Rust backend\n│   ├── src/\n│   │   ├── commands/      # Tauri command handlers\n│   │   ├── sandbox/       # Security sandboxing\n│   │   └── checkpoint/    # Timeline management\n│   └── tests/             # Rust test suite\n└── public/                # Public assets\n```\n\n### Development Commands\n\n```bash\n# Start development server\nbun run tauri dev\n\n# Run frontend only\nbun run dev\n\n# Type checking\nbunx tsc --noEmit\n\n# Run Rust tests\ncd src-tauri \u0026\u0026 cargo test\n\n# Format code\ncd src-tauri \u0026\u0026 cargo fmt\n```\n\n## 🔒 Security\n\nClaudia implements multiple layers of security:\n\n1. **Process Isolation**: Agents run in separate sandboxed processes\n2. **Filesystem Access Control**: Whitelist-based file access\n3. **Network Restrictions**: Control external connections\n4. **Audit Logging**: All security violations are logged\n5. **No Data Collection**: Everything stays local on your machine\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Areas for Contribution\n\n- 🐛 Bug fixes and improvements\n- ✨ New features and enhancements\n- 📚 Documentation improvements\n- 🎨 UI/UX enhancements\n- 🧪 Test coverage\n- 🌐 Internationalization\n\n## 📄 License\n\nThis project is licensed under the AGPL License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Tauri](https://tauri.app/) - The secure framework for building desktop apps\n- [Claude](https://claude.ai) by Anthropic\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eMade with ❤️ by the \u003ca href=\"https://asterisk.so/\"\u003eAsterisk\u003c/a\u003e\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/getAsterisk/claudia/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/getAsterisk/claudia/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=getAsterisk/claudia\u0026type=Date)](https://www.star-history.com/#getAsterisk/claudia\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FgetAsterisk%2Fclaudia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FgetAsterisk%2Fclaudia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FgetAsterisk%2Fclaudia/lists"}