{"id":29806337,"url":"https://github.com/Haleclipse/Claudiatron","last_synced_at":"2025-07-28T14:08:07.859Z","repository":{"id":304133473,"uuid":"1017609755","full_name":"Haleclipse/Claudiatron","owner":"Haleclipse","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-11T10:43:36.000Z","size":1208,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-11T11:44:09.306Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Haleclipse.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-07-10T20:03:20.000Z","updated_at":"2025-07-11T10:42:51.000Z","dependencies_parsed_at":"2025-07-11T11:44:17.999Z","dependency_job_id":"ad28c7ec-83d1-4908-983a-d7951cac84e3","html_url":"https://github.com/Haleclipse/Claudiatron","commit_stats":null,"previous_names":["haleclipse/claudiatron"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Haleclipse/Claudiatron","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haleclipse%2FClaudiatron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haleclipse%2FClaudiatron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haleclipse%2FClaudiatron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haleclipse%2FClaudiatron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Haleclipse","download_url":"https://codeload.github.com/Haleclipse/Claudiatron/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haleclipse%2FClaudiatron/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267527835,"owners_count":24102019,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-07-28T14:05:57.683Z","updated_at":"2025-07-28T14:08:07.852Z","avatar_url":"https://github.com/Haleclipse.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./build/icon.png\" alt=\"Claudiatron Logo\" width=\"120\" height=\"120\"\u003e\n\n  \u003ch1\u003eClaudiatron\u003c/h1\u003e\n  \n  \u003cp\u003e\n    \u003cstrong\u003eA Powerful Claude Code GUI Desktop Application\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eBuilt with Electron + React + TypeScript, providing complete Claude Code integration\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  \n  \u003cp\u003e\n    \u003ca href=\"README.zh.md\"\u003e中文\u003c/a\u003e | \u003cstrong\u003eEnglish\u003c/strong\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 🌟 Overview\n\n**Claudiatron** is a modern desktop application built with Electron + React + TypeScript, serving as a visual GUI for Claude Code. It evolved from the original Tauri version, providing a more comprehensive and stable Claude Code integration experience.\n\nThink of Claudiatron as your command center for Claude Code - bridging the gap between the command-line tool and an intuitive visual interface that makes AI-assisted development more efficient and convenient.\n\n## 📋 Table of Contents\n\n- [🌟 Overview](#-overview)\n- [✨ Features](#-features)\n  - [🗂️ Project \u0026 Session Management](#️-project--session-management)\n  - [🤖 AI Agents System](#-ai-agents-system)\n  - [📊 Usage Analytics Dashboard](#-usage-analytics-dashboard)\n  - [🔌 MCP Server Management](#-mcp-server-management)\n  - [📝 CLAUDE.md Management](#-claudemd-management)\n  - [🌐 Internationalization](#-internationalization)\n  - [🎨 Modern Interface](#-modern-interface)\n- [📖 Usage](#-usage)\n- [🚀 Installation](#-installation)\n- [🔨 Build from Source](#-build-from-source)\n- [🛠️ Development](#️-development)\n- [🔒 Security](#-security)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n\n## ✨ Features\n\n### 🗂️ **Project \u0026 Session Management**\n\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### 🤖 **AI Agents System**\n\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- **Background Execution**: Run agents in separate processes for non-blocking operations\n- **Execution History**: Track all agent runs with detailed logs and performance metrics\n- **GitHub Agent Import**: Import predefined agent configurations from GitHub\n\n### 📊 **Usage Analytics Dashboard**\n\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\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- **Batch Import/Export**: Support for bulk configuration import and export\n\n### 📝 **CLAUDE.md Management**\n\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### 🌐 **Internationalization**\n\n- **Multi-language Interface**: Support for Chinese and English interfaces\n- **Smart Language Detection**: Automatically detect and apply system language\n- **Dynamic Switching**: Seamlessly switch languages at runtime\n- **Complete Localization**: All interface elements are localized\n\n### 🎨 **Modern Interface**\n\n- **Responsive Design**: Adapts to different screen sizes and resolutions\n- **Dark/Light Theme**: Supports automatic system theme switching\n- **Smooth Animations**: Fluid interface animations using Framer Motion\n- **Material Design**: Modern component library based on shadcn/ui and Radix UI\n\n## 📖 Usage\n\n### Getting Started\n\n1. **Launch Claudiatron**: Open the application after installation\n2. **Welcome Screen**: Choose between CC Agents or CC Projects\n3. **First Time Setup**: Claudiatron 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 Permissions**: Configure file read/write and network access\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### 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### Prerequisites\n\n- **Claude Code CLI**: Install from [Claude's official site](https://claude.ai/code)\n\n### Release Downloads\n\nRelease executables will be published soon.\n\n## 🔨 Build from Source\n\n### Development Environment\n\n1. **Node.js** (18.0.0 or later)\n\n   ```bash\n   # Install via nvm (recommended)\n   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash\n   nvm install 18\n   nvm use 18\n   ```\n\n2. **pnpm** (latest version)\n\n   ```bash\n   # Install pnpm\n   npm install -g pnpm\n   ```\n\n3. **Git**\n\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### Build Steps\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/Haleclipse/Claudiatron.git\n   cd Claudiatron\n   ```\n\n2. **Install Dependencies**\n\n   ```bash\n   pnpm install\n   ```\n\n3. **Build the Application**\n\n   **For Development (with hot reload)**\n\n   ```bash\n   pnpm dev\n   ```\n\n   **For Production Build**\n\n   ```bash\n   # Build the application\n   pnpm build\n\n   # Platform-specific builds\n   pnpm build:win     # Windows\n   pnpm build:mac     # macOS\n   pnpm build:linux   # Linux\n   ```\n\n### Development Commands\n\n```bash\n# Start development server\npnpm dev\n\n# Code checking\npnpm lint\npnpm typecheck\n\n# Code formatting\npnpm format\n\n# Build for production\npnpm build\n```\n\n## 🛠️ Development\n\n### Tech Stack\n\n- **Frontend**: React 19 + TypeScript + Vite 6\n- **Backend**: Electron + Node.js\n- **UI Framework**: Tailwind CSS v4 + shadcn/ui\n- **Database**: SQLite (via TypeORM + better-sqlite3)\n- **Package Manager**: pnpm\n- **Animations**: Framer Motion\n- **Internationalization**: react-i18next\n\n### Project Structure\n\n```\nclaudiatron/\n├── src/\n│   ├── main/                  # Electron main process\n│   │   ├── api/              # IPC API handlers\n│   │   ├── database/         # Database layer\n│   │   ├── detection/        # Claude detection\n│   │   └── process/          # Process management\n│   ├── preload/              # Preload scripts\n│   └── renderer/             # React renderer process\n│       ├── src/\n│       │   ├── components/   # UI components\n│       │   ├── lib/         # API client \u0026 utilities\n│       │   ├── i18n/        # Internationalization\n│       │   └── types/       # TypeScript types\n│       └── assets/          # Static assets\n├── build/                    # Build resources\n└── dist/                     # Build output\n```\n\n### Core Architecture\n\n- **Main Process**: Manages app lifecycle, file system access, child process management\n- **Preload Scripts**: Provides secure communication bridge between main and renderer processes\n- **Renderer Process**: React application interface, handles user interactions\n- **Database**: SQLite stores application data, session history, usage statistics\n\n### IPC Communication\n\nThe project uses type-safe IPC communication:\n\n```typescript\n// Renderer process calls\nconst projects = await api.getProjects()\nconst session = await api.createClaudeSession(projectPath)\n\n// Main process handlers\nipcMain.handle('get-projects', async () =\u003e { ... })\nipcMain.handle('create-claude-session', async (_, projectPath) =\u003e { ... })\n```\n\n## 🔒 Security\n\nClaudiatron prioritizes your privacy and security:\n\n1. **Process Isolation**: Agents run in separate processes\n2. **Permission Control**: Configure file and network access per agent\n3. **Local Storage**: All data stays on your machine\n4. **No Telemetry**: No data collection or tracking\n5. **Open Source**: Full transparency through open source code\n6. **Sandboxed Environment**: Renderer process runs in a restricted environment\n\n## 🤝 Contributing\n\nWe welcome contributions of all kinds!\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### Development Workflow\n\n1. Fork the project\n2. Create a feature branch\n3. Commit your changes\n4. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the [LICENSE](LICENSE) file for details.\n\n**Important**: This project is based on [Claudia](https://github.com/getAsterisk/claudia), which is licensed under AGPL-3.0. As required by the AGPL-3.0 license terms, all derivative works must maintain the same license.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eBuilt with Electron for modern desktop experiences\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/Haleclipse/Claudiatron/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Haleclipse/Claudiatron/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n","funding_links":[],"categories":["GUIs \u0026 Web UIs"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHaleclipse%2FClaudiatron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHaleclipse%2FClaudiatron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHaleclipse%2FClaudiatron/lists"}