English | 中文 | 日本語 | 한국어 | Русский | Español | Türkçe | العربية | Bahasa Indonesia | தமிழ் | हिन्दी
-0ea5e9?style=flat-square){kind=icon}
-0ea5e9?style=flat-square){kind=icon}
-0ea5e9?style=flat-square){kind=icon}
-0ea5e9?style=flat-square){kind=icon}
-0ea5e9?style=flat-square){kind=icon}
Coworker™ - Open Source AI Desktop Agent
Coworker 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 for Mac (Apple Silicon) · Download for Mac (Intel) · Download for Windows 11 · Download for Linux (ARM64) · Download for Linux (x64) · Download for Linux (.deb x64) · Coworker releases
What makes it different
🖥️ It runs locally
|
🔑 You bring your own AI
|
📖 It's open source
|
⚡ It acts, not just chats
|
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
- Anthropic (Claude)
- OpenAI (GPT)
- Google AI (Gemini)
- xAI (Grok)
- DeepSeek
- Moonshot AI (Kimi)
- Z.AI (GLM)
- MiniMax
- Venice.ai
- Amazon Bedrock
- Azure Foundry
- OpenRouter
- LiteLLM
- Ollama (local models)
- LM Studio (local models)
Privacy and local-first
Coworker runs locally on your machine. Your files stay on your device, and you choose which folders it can access.
System requirements
- macOS (Apple Silicon)
- macOS (Intel)
- Windows 11
- Ubuntu (ARM64)
- Ubuntu (x64)
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 Google, OpenAI, Anthropic (or other) API key — or sign in with ChatGPT (Plus/Pro). 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. |
Download for Mac (Apple Silicon) · Download for Mac (Intel) · Download for Windows 11 · Download for Linux (ARM64) · Download for Linux (x64) · Download for Linux (.deb x64)
Screenshots and Demo
A quick look at Coworker on macOS, plus a short demo video.
FAQ
Does Coworker run locally?
Yes. Coworker 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, etc.) or run local models via Ollama.
Is Coworker free?
Yes. Coworker is open source and MIT licensed.
Which platforms are supported? macOS (Apple Silicon), macOS (Intel), Windows 11, Ubuntu ARM64, and Ubuntu x64 are supported.
Development
pnpm install
pnpm devThat'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 -F @coworker/desktop package:win |
Build Windows installer (x64) |
pnpm -F @coworker/desktop package:linux |
Build Linux artifacts (AppImage + deb) |
pnpm lint |
TypeScript checks |
pnpm typecheck |
Type validation |
pnpm -F @coworker/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. A long-lived apps/daemon background process owns task execution — it spawns OpenCode opencode serve children and talks to them via @opencode-ai/sdk. 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-featureCoworker releases · Issues · Twitter
MIT License
Keywords: AI agent, AI desktop agent, desktop automation, file management, document creation, browser automation, local-first, macOS, linux, ubuntu, privacy-first, open source, Electron, computer use, AI assistant, workflow automation, OpenAI, Anthropic, Google, xAI, Claude, GPT-4, Ollama
