Skip to content

LiamFuller07/openwork

Repository files navigation

OpenWork

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.

License: MIT TypeScript Electron PRs Welcome

Quick Start | Features | Documentation | Contributing


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

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

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:

License

MIT License - see LICENSE for details.


About

Open-source alternative to Claude Cowork - Universal AI agent platform for completing tasks with AI. Model-agnostic (Claude, Gemini, OpenAI, Ollama), plan-mode by default, sandboxed file ops, browser automation.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors