OpenWork

<div align="center">

AI-powered task automation for everyone

Complete tasks like developers use Claude Code, Codex, or Gemini CLI - but with a friendly interface designed for non-technical users.

Quick Start | Features | Documentation | Contributing

</div>

---

Why OpenWork?

Problem: Powerful AI coding tools like Claude Code, Codex, and Gemini CLI are built for developers. Non-technical users miss out on AI-powered task automation.

Solution: OpenWork brings the same power to everyone through a simple desktop app.

| Feature | Claude Cowork | OpenWork | |---------|---------------|----------| | License | Proprietary | MIT (Open Source) | | Price | $200/month | Free | | Models | Claude only | Any provider (Claude, GPT, Gemini, Local) | | Self-hosting | No | Yes | | Customization | Limited | Full source access |

Quick Start

Get running in under 2 minutes:

Prerequisites

• Node.js 20+
• pnpm 9+ (npm install -g pnpm)
• API key from any provider (or use Ollama for free local models)

Install and Run

# Clone the repo
git clone https://github.com/openwork-ai/openwork.git
cd openwork

# Install dependencies
pnpm install

# Set up your API keys
cp .env.example .env
# Edit .env and add at least one API key

# Launch the app
pnpm dev:desktop

First Task

1. Select a folder - Choose where OpenWork can read/write files
2. Pick a provider - Claude, Gemini, OpenAI, or Ollama
3. Try a quick action - Click "Create a file" or type your own request

Features

Task Automation

| Capability | Description | |------------|-------------| | File Management | Read, write, edit files in a sandboxed directory | | Task Planning | AI breaks complex requests into actionable subtasks | | Progress Tracking | Visual checklist showing real-time completion | | Browser Automation | Complete web tasks with browser-use + Playwright | | MCP Connectors | Connect to Google Calendar, Slack, Notion, and more |

Quick Actions

Pre-built templates to get started instantly:

• Create a file - Generate documents, spreadsheets, presentations
• Crunch data - Analyze files, extract insights, create summaries
• Make a prototype - Design mockups and wireframes
• Prep for the day - Review calendar, summarize meetings
• Organize files - Sort, rename, categorize documents
• Send a message - Draft and send emails or messages

Multi-Provider Support

Use the AI provider that works best for you:

| Provider | Models | Setup | |----------|--------|-------| | Anthropic | claude-sonnet-4, claude-opus-4.5 | Get API key | | Google | gemini-2.5-pro, gemini-3-pro | Get API key | | OpenAI | gpt-5, gpt-5-codex, o3 | Get API key | | Ollama | llama3.3, qwen2.5, deepseek-r1 | Install Ollama (free, local) |

Architecture

OpenWork Desktop App
+----------------------------------------------------------+
|  React/Electron Frontend                                  |
|  +------------+  +---------------+  +------------------+  |
|  | File       |  | Task Engine   |  | Context          |  |
|  | Browser    |  | + Progress UI |  | Manager          |  |
|  +------------+  +---------------+  +------------------+  |
+----------------------------------------------------------+
                           |
+----------------------------------------------------------+
|  OpenWork Core (TypeScript)                               |
|  - Task planning and decomposition                        |
|  - Tool selection and execution                           |
|  - Progress tracking and reporting                        |
+----------------------------------------------------------+
                           |
+----------------------------------------------------------+
|  SDK Integration Layer                                    |
|  +--------+ +--------+ +--------+ +------------------+    |
|  | Claude | | Gemini | | OpenAI | | Ollama (Local)   |    |
|  +--------+ +--------+ +--------+ +------------------+    |
+----------------------------------------------------------+

Project Structure

openwork/
├── apps/
│   └── desktop/          # Electron desktop application
├── packages/
│   ├── core/             # Agent orchestration engine
│   ├── file-tools/       # Sandboxed file operations
│   ├── browser-tools/    # Browser automation
│   ├── sdk-adapters/     # Multi-provider adapters
│   ├── mcp-connectors/   # MCP server integrations
│   └── ui/               # Shared UI components
├── docs/                 # Documentation
└── scripts/              # Build and release scripts

Documentation

• Getting Started Guide - Detailed setup instructions
• Architecture Guide - How the prompting and workflow system works
• Testing Guide - Manual testing checklist
• Troubleshooting - Common issues and solutions

Development

# Run all packages in dev mode
pnpm dev

# Run tests
pnpm test

# Build all packages
pnpm build

# Type check
pnpm typecheck

# Format code
pnpm format

Contributing

We welcome contributions! Here's how to get started:

1. Fork the repo and create your branch from main
2. Make your changes and add tests if applicable
3. Run tests with pnpm test
4. Submit a pull request

See our Contributing Guide for detailed guidelines.

Good First Issues

Look for issues labeled good first issue to get started.

Acknowledgments

OpenWork builds on these amazing projects:

• Claude Agent SDK - Anthropic
• Gemini CLI - Google
• OpenAI Codex - OpenAI
• browser-use - Browser automation for AI
• Playwright - Microsoft

License

MIT License - see LICENSE for details.

---

<div align="center">

Star us on GitHub to support the project

Report Bug | Request Feature | Join Discord

</div>