GitHub - CoWork-OS/CoWork-OS: Rent the model. Own everything else. Free, open-source AI app for real work. · GitHub
Skip to content
CoWork-OSPublic

Latest commit

 

History

10,993 Commits

Folders and files

Repository files navigation

CoWork OS

The AI desktop where every action is visible and approvable before it runs.

Rent the model. Own everything else.

npm CI License: MIT Discussions Discord Good first issues

English · 简体中文

CoWork OS is a free, open-source desktop app for macOS and Windows that does real work for you: files, documents, the browser, your inbox and scheduled jobs. You watch every step as it happens, and with the default Ask for approval profile the agent works freely inside your workspace but stops and asks before anything that leaves it: sending, network access, credentials, exports, or files outside the workspace. Use the model you choose; your workspace, memory, skills and history stay on your machine. Model providers may charge for usage and receive the data needed for the tasks you run. What you own

A task in CoWork OS: the plan fills in, the agent asks before running a command, and the finished spreadsheet opens beside the chat

MIT licensed · runs on your machine · 17,000+ automated tests · independent security assessment · contributions welcome

What you can do with it

  • Turn a folder of files into finished work. "Make a spreadsheet of these invoices with a total per vendor" — the spreadsheet opens beside the chat, editable, and you can ask for changes in place.
  • Get through your inbox without losing control. It triages, summarizes and drafts replies; nothing is sent until you approve it.
  • Research in a browser you can watch. The agent browses in a visible window you can take over at any time, and hands back a report with its sources.
  • Put a bot on a schedule. A bot with its own memory posts a morning summary to Telegram, Slack or Discord, and asks you before it acts outside its scope.
  • Make 3D models and game assets. "Make a low-poly treasure chest for my Godot game" — Meshy builds it, the approval card names the credit cost first, and the model appears in the chat as a 3D view you can spin, animate and download. 3D Models with Meshy
  • Work on code with every command shown. Real terminal tabs, diffs and test runs in the timeline, and approvals for anything risky.
  • Keep it all local if you want. Run on Ollama or LM Studio on your own machine, or sign in with OpenRouter and use free models with no API key to copy.
Today: one card per decision that needs you An approval card in the middle of a task A generated spreadsheet open beside the conversation
Today: what needs you, one card each Every risky step waits for your answer Results open beside the chat
See every step, approve the risky ones The timeline shows each file read, command and edit as it happens. Access profiles (Ask for approval, Approve for me, Full access, Custom) decide what waits for you, and hard limits hold even if you approve. Access profiles
Get finished files, not just answers Documents, spreadsheets, decks, web pages and PDFs open beside the agent, editable, and you can ask for changes without starting over. Everything Workbench
An inbox that drafts, you send Local-first triage, search across your mail, and reply drafts; sending always waits for you. Inbox Agent
A browser you can watch and take over Real tabs that stay loaded, downloads and history, and logins filled only on the exact site after you confirm. Browser Workbench
Bots that work while you don't Bots with their own memory, model and schedule, reachable on Telegram, Slack, Discord, WhatsApp and more. Bots · Channels
Memory you can open and edit What CoWork knows about you is plain markdown in a local git folder: read it, change it, sync it or delete it. Memory
Any model you choose, switch any time OpenRouter sign-in with free models, ChatGPT sign-in, local Ollama or LM Studio, or API keys for Claude, OpenAI, Gemini, Groq and more, per conversation. Models & Access

Why CoWork OS?

If you use… You might choose CoWork OS when you want…
A terminal agent (Hermes Agent, OpenClaw, Claude Code) The same kind of agent in a desktop app, with approvals you can see, files that open beside the chat, and memory you can read. CoWork can import a Hermes or OpenClaw setup.
A hosted desktop assistant (ChatGPT, Claude Cowork) An open-source app where you pick the model, run local models, and keep your workspace, memory and history on your machine.
A coding agent (Cursor, Codex) One workspace for code and everything around it: documents, inbox, browser, bots and schedules.

These are fit notes, not rankings; see Compare CoWork OS for each product's strengths and the evidence behind each page.

Install

macOS (Apple Silicon, macOS 13 or later). No Gatekeeper dialog:

curl -fsSL https://coworkosapp.com/install.sh | bash

Windows (64-bit), in PowerShell. No SmartScreen prompt:

irm https://coworkosapp.com/install.ps1 | iex

Any platform with Node.js 24, including Intel Macs. Installs the desktop app and the cowork CLI:

npm install -g cowork-os

Linux servers: use the packaged headless server. Re-run the same command to update.

Trouble installing? Use the DMG or EXE instead

Download the installer from GitHub Releases. Releases are not notarized by Apple or code signed for Windows, so a browser download needs one extra step the first time:

  • macOS DMG: drag CoWork OS into Applications and open it. When macOS says it was not opened, click Done, then go to System Settings > Privacy & Security and click Open Anyway. Step-by-step screenshots: macOS Installation.
  • Windows EXE: when SmartScreen says Windows protected your PC, click More info > Run anyway. Checksums and antivirus notes: Windows Installation.
  • macOS 12 Monterey: 0.5.51 is the last compatible release: npm install -g cowork-os@0.5.51.

Getting started

  1. Open CoWork OS. On macOS the first start may ask for the cowork-os Safe Storage keychain item; click Always Allow.
  2. Pick a model. Choose Continue with OpenRouter for free models with no API key to copy (from 0.5.61), sign in with ChatGPT, use a detected local Ollama model, or paste an API key. Free options are marked, and you can switch models any time.
  3. Describe a task, for example "make a spreadsheet of my last ten invoices from ~/Downloads", or pick one from the use-case gallery.
  4. Watch and approve. The timeline shows each step. Work inside the workspace runs on its own; anything that sends, reaches the network, uses credentials or leaves the workspace waits for your answer.

From the terminal: cowork opens the terminal UI and cowork run "who are you?" runs a one-shot task against the same local profile. Getting Started · CoWork CLI

Migrating from Hermes or OpenClaw

Bring your Hermes Agent or OpenClaw setup with you (from 0.5.61). CoWork reads ~/.hermes or ~/.openclaw without changing it and shows what it would import before anything is written: persona, memory, your own skills, model choice, chat bots and their allowlists, and scheduled jobs. API keys and bot tokens come over only if you ask, and go to the operating system's encrypted storage.

cowork import --from hermes --dry-run
cowork import --from hermes

Use --from openclaw for OpenClaw, or Settings > Import in the app; first-run setup offers it when it finds either folder. You can also keep running your existing Hermes and hand tasks to it from CoWork over ACP. Guides: Migrating from Hermes · Migrating from OpenClaw

Documentation

Getting Started Install, first model, first task
Feature Tour Why CoWork OS, how a task runs, and the full feature inventory
Features Categorized feature reference
Models & Access Provider routes, sign-ins, local models, fallbacks
Migrating from Hermes · OpenClaw Import persona, memory, skills, bots and schedules
Access Profiles Approvals, sandbox, network and filesystem policy
Security Guide Threat model, guardrails, sandboxing, credential storage
Self-Hosting Linux server, Docker and remote access
Development Build from source and run the tests
All docs · Changelog · Release Notes 0.5.61

Community

Public Adoption Signals

Signal Current All time
GitHub stars 514 n/a
GitHub forks 93 n/a
Installer/server downloads 2,183 2,183
Download delta +23 n/a
npm downloads 139 (last week) 9,985
GitHub views, last 14-ish days 832 total / 511 unique n/a
GitHub clones, last 14-ish days 32,632 total / 1,718 unique n/a

Generated 2026-10-27T08:56:13.791Z. These are public GitHub/npm adoption signals, not active-user or in-app telemetry numbers. All-time values are shown only where the source API provides lifetime coverage. Full report.

License

MIT License. See LICENSE.


"Cowork" is an Anthropic product name. CoWork OS is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Anthropic. If requested by the rights holder, we will update naming/branding. osai-verify: b359fb38a6b6ca5e28d0

Releases

Packages

Used by

Contributors

Languages