Skip to content

accomplish-ai/openwork

Repository files navigation

Openwork - Open source AI desktop agent that automates file management, document creation, and browser tasks with your own AI API keys

MIT License GitHub Stars GitHub Issues Last Commit Download for macOS

Openwork™ - Open Source AI Desktop Agent

Openwork is an open source AI desktop agent that automates file management, document creation, and browser tasks locally on your machine. Bring your own API keys (OpenAI, Anthropic, Google, xAI) or run local models via Ollama.

Runs locally on your machine. Bring your own API keys or local models. MIT licensed.

Download Openwork for Mac (Apple Silicon) · Openwork website · Openwork blog · Openwork releases




What makes it different

🖥️ It runs locally

  • Your files stay on your machine
  • You decide which folders it can touch
  • Nothing gets sent to Openwork (or anyone else)

🔑 You bring your own AI

  • Use your own API key (OpenAI, Anthropic, etc.)
  • Or run with Ollama (no API key needed)
  • No subscription, no upsell
  • It's a tool—not a service

📖 It's open source

  • Every line of code is on GitHub
  • MIT licensed
  • Change it, fork it, break it, fix it

⚡ It acts, not just chats

  • File management
  • Document creation
  • Custom automations
  • Skill learning



What it actually does

📁 File Management ✍️ Document Writing 🔗 Tool Connections
Sort, rename, and move files based on content or rules you give it Prompt it to write, summarize, or rewrite documents Works with Notion, Google Drive, Dropbox, and more (through local APIs)
⚙️ Custom Skills 🛡️ Full Control
Define repeatable workflows, save them as skills You approve every action. You can see logs. You can stop it anytime.

Use cases

  • Clean up messy folders by project, file type, or date
  • Draft, summarize, and rewrite docs, reports, and meeting notes
  • Automate browser workflows like research and form entry
  • Generate weekly updates from files and notes
  • Prepare meeting materials from docs and calendars

Supported models and providers

  • OpenAI
  • Anthropic
  • Google
  • xAI
  • Ollama (local models)

Privacy and local-first

Openwork runs locally on your machine. Your files stay on your device, and you choose which folders it can access.


System requirements

  • macOS (Apple Silicon)
  • Windows support coming soon



How to use it

Takes 2 minutes to set up.

Step Action Details
1 Install the App Download the DMG and drag it into Applications
2 Connect Your AI Use your own OpenAI or Anthropic API key, or Ollama. No subscriptions.
3 Give It Access Choose which folders it can see. You stay in control.
4 Start Working Ask it to summarize a doc, clean a folder, or create a report. You approve everything.




Screenshots and Demo

A quick look at Openwork on macOS, plus a short demo video.

Openwork demo - AI agent automating file management and browser tasks

Watch the demo →


FAQ

Does Openwork run locally?
Yes. Openwork runs locally on your machine and you control which folders it can access.

Do I need an API key?
You can use your own API keys (OpenAI, Anthropic, Google, xAI) or run local models via Ollama.

Is Openwork free?
Yes. Openwork is open source and MIT licensed.

Which platforms are supported?
macOS (Apple Silicon) is available now. Windows support is coming soon.




Development

pnpm install
pnpm dev

That's it.

Prerequisites
  • Node.js 20+
  • pnpm 9+
All Commands
Command Description
pnpm dev Run desktop app in dev mode
pnpm dev:clean Dev mode with clean start
pnpm build Build all workspaces
pnpm build:desktop Build desktop app only
pnpm lint TypeScript checks
pnpm typecheck Type validation
pnpm -F @accomplish/desktop test:e2e Playwright E2E tests
Environment Variables
Variable Description
CLEAN_START=1 Clear all stored data on app start
E2E_SKIP_AUTH=1 Skip onboarding flow (for testing)
Architecture
apps/
  desktop/        # Electron app (main + preload + renderer)
packages/
  shared/         # Shared TypeScript types

The desktop app uses Electron with a React UI bundled via Vite. The main process spawns OpenCode CLI using node-pty to execute tasks. API keys are stored securely in the OS keychain.

See CLAUDE.md for detailed architecture documentation.




Contributing

Contributions welcome! Feel free to open a PR.

# Fork → Clone → Branch → Commit → Push → PR
git checkout -b feature/amazing-feature
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature



Openwork website · Openwork blog · Openwork releases · Issues · Twitter


MIT License · Built by Accomplish


Keywords: AI agent, AI desktop agent, desktop automation, file management, document creation, browser automation, local-first, macOS, privacy-first, open source, Electron, computer use, AI assistant, workflow automation, OpenAI, Anthropic, Google, xAI, Claude, GPT-4, Ollama

About

Openwork™ is the open source Al coworker that lives on your desktop

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 9