xsha is a software system that combines project management, Git, and AI-driven development. Based on Claude Code, it enables project task development through conversational interactions, with multiple tasks running concurrently, each with its own isolated workspace. Docker containers are used to allocate execution environments for each task, ensuring security. With ENV variable configuration, you can easily integrate more cost-effective large language models like Kimi K2, GLM 4.5, and Qwen Coder. ✨
- 🧠 AI-Driven Project Task Automation: Built on Claude Code, with development capabilities limited only by Claude Code's potential. Also supports models like Kimi K2/GLM 4.5/Qwen Coder.
- 🛡️ Isolated Execution Environments: Docker-based container solution ensures each Claude Code execution runs in its own isolated container for security.
- ⚡ Concurrent Task Execution: Controllable concurrency allows for faster project task development.
- 🔄 Git Integration: Directly import Git repositories, push completed project tasks to repositories with one click, and view Git diffs online.
- ⏰ Scheduled Task Execution: Support for automated task scheduling and execution at specified times with ultrathink capabilities.
- 📎 Rich Attachment Support: Upload and process images, PDFs, and other file attachments for enhanced task context.
- 📋 Project Kanban Management: Visual task management with drag-and-drop Kanban boards for better project organization.
- 🔔 Message Notifications: Real-time push notifications for task status changes, execution results, and other important events with multiple notification channels.
- 🔌 MCP Management: Integrated Model Context Protocol server management for easy extension of AI capabilities and toolsets.
- 📥 Clone the repository
git clone https://github.com/XshaLabs/xsha.git && cd xsha- 🚀 Start the application
sudo chmod 666 /var/run/docker.sock && docker compose up -d- 🌍 Access the application
- Frontend: http://localhost:8080
- 🔑 Default credentials
- Username: xshauser
- Password: xshapass
- Docker & Docker Compose: For containerized deployment 🐳
- Go 1.21+: For local development (optional) 🐹
- Node.js 18+: For frontend development (optional) 📦
- Make: For build automation (optional) 🔨
- 🗄️ Backend setup
cd backend
make deps # Download dependencies
make dev # Start development server- 🎨 Frontend setup
cd frontend
npm install # Install dependencies
npm run dev # Start development serverWe welcome contributions from the community! Here's how you can get involved: 🎉
- 🍴 Fork the repository and clone your fork
- 🌿 Create a feature branch:
git checkout -b feature/amazing-feature
- ✅ Ensure tests pass and coverage is maintained
- 📚 Update documentation for any API changes
- 📋 Follow the PR template and provide clear descriptions
- 👀 Request review from maintainers
- 📄 Use the issue templates provided
- 🔍 Include reproduction steps and environment details
- 🏷️ Label issues appropriately (bug, enhancement, question, etc.)
This repository is licensed under the xsha Open Source License, based on Apache 2.0 with additional conditions. ⚖️
Built with ❤️ by the xsha team 👨💻👩💻