Skip to content

kuse-ai/kuse_cowork

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kuse Cowork Logo

DISCORD

Open-source Alternative for Claude Code Desktop App

Works with any models, BYOK, written in Rust πŸš€

cowoker-demo.mp4

✨ 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: ~10MB 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.

2. βš™οΈ 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-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

5. 🎯 Start Your First Task!

  1. 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

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

# 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 for details.

πŸ—οΈ Built With

  • Tauri - Lightweight desktop framework
  • Rust - 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:


⭐ Star this repo if you find it useful!

About

Open-source Alternative for Claude Code Desktop App

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •