Skip to content
Back to search

CoWork-OS

Local-first personal agentic OS and everything app for coding, knowledge work, web design, automations, and artifacts.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/CoWork-OS/CoWork-OS with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/CoWork-OS/CoWork-OS'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cowork-os--cowork-os/badge.svg)](/listings/cowork-os--cowork-os)

HTML

<a href="/listings/cowork-os--cowork-os"><img src="/api/listings/cowork-os--cowork-os/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Download the App

Download the latest release from [GitHub Releases](https://github.com/CoWork-OS/CoWork-OS/releases/latest):

| Platform | Download | Install | | ----------------------------- | ----------------------- | ---------------------------------------- | | **macOS 13 Ventura or later** | `.dmg` | Drag CoWork OS into Applications | | **Windows** | `.exe` (NSIS installer) | Run the installer and follow the prompts |

> **macOS 12 Monterey:** `0.5.51` is the final compatible CoWork OS release. The `0.5.54` app, installer, and automatic updater require macOS 13 or later. npm users who must remain on Monterey can run `npm install -g cowork-os@0.5.51`; this does not remove their existing CoWork data.

macOS unsigned app workaround

This Gatekeeper warning is different from the macOS 13 system requirement. On a supported Mac, an unsigned CoWork OS DMG may still need a one-time Gatekeeper override:

1. Open the downloaded `.dmg` and drag **CoWork OS** into **Applications**.

2. Open **CoWork OS** from Applications. If macOS says `"CoWork OS" Not Opened`, click **Done**.

3. Open **System Settings > Privacy & Security**, scroll to **Security**, and click **Open Anyway** next to `"CoWork OS" was blocked to protect your Mac`.

4. In the confirmation dialog, click **Open Anyway**.

5. On first startup, macOS may ask for access to the `cowork-os Safe Storage` keychain item. Enter your Mac login password and click **Always Allow** so CoWork OS can store local credentials securely.

Release maintainers can create this unsigned DMG/ZIP with `npm run package:mac:unsigned`.

> **Windows first launch:** Windows SmartScreen may show a warning for unrecognized apps. Click **More info** > **Run anyway** to proceed.

> First launch asks how you want to power AI: sign in with an existing ChatGPT subscription, use a local Ollama model, or add an API key for Claude, OpenAI API, Gemini, OpenRouter, Groq, and other providers. After onboarding, Apple Silicon users can configure [MLX-LM](docs/mlx-lm.md) in Settings. OpenRouter, Gemini through Google AI Studio, and Groq are marked when a free option is available. After at least two model routes work, you can create a Mixture of Agents preset that combines them. You can explore the app without AI, but tasks require one working model route.

Or Install via npm

npm install -g cowork-os
cowork-os
cowork
cowork run "who are you?"

`cowork-os` launches the desktop GUI. `cowork` launches the terminal UI, `cowork run` starts a local one-shot task, and commands like `cowork status`, `cowork sessions list`, `cowork tools list`, `cowork mcp list`, `cowork backup create`, and `cowork security audit` manage the same local profile, provider settings, workspaces, skills, and MCP configuration. Use `--remote` only when intentionally calling a remote Control Plane endpoint.

> **Windows npm install notes:** > > - Run `npm install -g cowork-os` / `npm uninstall -g cowork-os` from `%USERPROFILE%` (or another neutral directory), **not** from `%APPDATA%\npm\node_modules\cowork-os`, to avoid `EBUSY` lock errors. > - On Windows ARM64, first launch may take longer while native modules are rebuilt; this can run multiple fallback steps before the app opens. > - If native rebuild fails, install [Visual Studio Build Tools 2022 (C++)](https://visualstudio.microsoft.com/visual-cpp-build-tools/) and Python 3, then retry. > - If startup logs show `ERR_FILE_NOT_FOUND ... dist/renderer/index.html`, reinstall the latest package and check [Troubleshooting](docs/troubleshooting.md).

Or Build from Source

git clone https://github.com/CoWork-OS/CoWork-OS.git
cd CoWork-OS
npm install && npm run setup
npm run build && npm run package

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="screenshots/cowork-os-sl-dark-logo.png">
  4. <source media="(prefers-color-scheme: light)" srcset="screenshots/cowork-os-sl-color-logo.png">
  5. <img src="screenshots/cowork-os-sl-color-logo.png" alt="CoWork OS" width="600">
  6. </picture>
  7. </p>
  8. <h3 align="center">The AI desktop where every action is visible and approvable before it runs.</h3>
  9. <p align="center"><strong>Rent the model. Own everything else.</strong></p>
  10. <p align="center">
  11. <a href="https://www.npmjs.com/package/cowork-os"><img src="https://img.shields.io/npm/v/cowork-os.svg" alt="npm"></a>
  12. <a href="https://github.com/CoWork-OS/CoWork-OS/actions/workflows/ci.yml"><img src="https://github.com/CoWork-OS/CoWork-OS/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  13. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
  14. <a href="https://github.com/CoWork-OS/CoWork-OS/discussions"><img src="https://img.shields.io/github/discussions/CoWork-OS/CoWork-OS" alt="Discussions"></a>
  15. <a href="https://discord.gg/UjykKwjhRC"><img src="https://img.shields.io/discord/1561115815695097986?label=Discord&logo=discord&logoColor=white" alt="Discord"></a>
  16. <a href="https://github.com/CoWork-OS/CoWork-OS/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22"><img src="https://img.shields.io/github/issues/CoWork-OS/CoWork-OS/good%20first%20issue" alt="Good first issues"></a>
  17. </p>
  18. <p align="center">
  19. <strong>English</strong> &middot; <a href="i18n/README.zh-CN.md">简体中文</a>
  20. </p>
  21. 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](docs/what-you-own.md)
  22. <p align="center">
  23. <img src="resources/branding/images/readme-demo.gif" alt="A task in CoWork OS: the plan fills in, the agent asks before running a command, and the finished spreadsheet opens beside the chat" width="820">
  24. </p>
  25. <p align="center"><sub>MIT licensed · runs on your machine · 17,000+ automated tests · <a href="ZeroLeaks-Report-jn70f56art03m4rj7fp4b5k9p180aqfd.pdf">independent security assessment</a> · contributions welcome</sub></p>
  26. ## What you can do with it
  27. - **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.
  28. - **Get through your inbox without losing control.** It triages, summarizes and drafts replies; nothing is sent until you approve it.
  29. - **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.
  30. - **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.
  31. - **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](docs/meshy-3d.md)
  32. - **Work on code with every command shown.** Real terminal tabs, diffs and test runs in the timeline, and approvals for anything risky.
  33. - **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.
  34. <table>
  35. <tr>
  36. <td width="33%"><img src="resources/branding/images/readme-today.webp" alt="Today: one card per decision that needs you"></td>
  37. <td width="33%"><img src="resources/branding/images/readme-approval.webp" alt="An approval card in the middle of a task"></td>
  38. <td width="33%"><img src="resources/branding/images/readme-workbench.webp" alt="A generated spreadsheet open beside the conversation"></td>
  39. </tr>
  40. <tr>
  41. <td align="center"><sub>Today: what needs you, one card each</sub></td>
  42. <td align="center"><sub>Every risky step waits for your answer</sub></td>
  43. <td align="center"><sub>Results open beside the chat</sub></td>
  44. </tr>
  45. </table>
  46. | | |
  47. | --- | --- |
  48. | **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](docs/access-profiles.md) |
  49. | **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](docs/everything-workbench.md) |
  50. | **An inbox that drafts, you send** | Local-first triage, search across your mail, and reply drafts; sending always waits for you. [Inbox Agent](docs/inbox-agent.md) |
  51. | **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](docs/browser-workbench.md) |
  52. | **Bots that work while you don't** | Bots with their own memory, model and schedule, reachable on Telegram, Slack, Discord, WhatsApp and more. [Bots](docs/bots-and-conversations.md) · [Channels](docs/channels.md) |
  53. | **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](docs/features.md#persistent-memory-system) |
  54. | **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](docs/providers.md) |
  55. ## Why CoWork OS?
  56. | If you use… | You might choose CoWork OS when you want… |
  57. | --- | --- |
  58. | 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. |
  59. | 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. |
  60. | A coding agent (Cursor, Codex) | One workspace for code and everything around it: documents, inbox, browser, bots and schedules. |
  61. These are fit notes, not rankings; see [Compare CoWork OS](docs/comparisons/index.md) for each product's strengths and the evidence behind each page.
  62. ## Install
  63. **macOS** (Apple Silicon, macOS 13 or later). No Gatekeeper dialog:
  64. ```bash
  65. curl -fsSL https://coworkosapp.com/install.sh | bash
  66. ```
  67. **Windows** (64-bit), in PowerShell. No SmartScreen prompt:
  68. ```powershell
  69. irm https://coworkosapp.com/install.ps1 | iex
  70. ```
  71. **Any platform with Node.js 24**, including Intel Macs. Installs the desktop app and the `cowork` CLI:
  72. ```bash
  73. npm install -g cowork-os
  74. ```
  75. Linux servers: use the [packaged headless server](docs/vps-linux.md). Re-run the same command to update.
  76. <details>
  77. <summary>Trouble installing? Use the DMG or EXE instead</summary>
  78. Download the installer from [GitHub Releases](https://github.com/CoWork-OS/CoWork-OS/releases/latest). Releases are not notarized by Apple or code signed for Windows, so a browser download needs one extra step the first time:
  79. - **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](docs/macos-installation.md).
  80. - **Windows EXE:** when SmartScreen says **Windows protected your PC**, click **More info > Run anyway**. Checksums and antivirus notes: [Windows Installation](docs/windows-installation.md).
  81. - **macOS 12 Monterey:** `0.5.51` is the last compatible release: `npm install -g cowork-os@0.5.51`.
  82. </details>
  83. ## Getting started
  84. 1. **Open CoWork OS.** On macOS the first start may ask for the `cowork-os Safe Storage` keychain item; click **Always Allow**.
  85. 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.
  86. 3. **Describe a task**, for example "make a spreadsheet of my last ten invoices from ~/Downloads", or pick one from the use-case gallery.
  87. 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.
  88. 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](docs/getting-started.md) · [CoWork CLI](docs/cli.md)
  89. ## Migrating from Hermes or OpenClaw
  90. 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.
  91. ```bash
  92. cowork import --from hermes --dry-run
  93. cowork import --from hermes
  94. ```
  95. 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](docs/migrating-from-hermes.md) · [Migrating from OpenClaw](docs/migrating-from-openclaw.md)
  96. ## Documentation
  97. | | |
  98. | --- | --- |
  99. | [Getting Started](docs/getting-started.md) | Install, first model, first task |
  100. | [Feature Tour](docs/feature-tour.md) | Why CoWork OS, how a task runs, and the full feature inventory |
  101. | [Features](docs/features.md) | Categorized feature reference |
  102. | [Models & Access](docs/providers.md) | Provider routes, sign-ins, local models, fallbacks |
  103. | [Migrating from Hermes](docs/migrating-from-hermes.md) · [OpenClaw](docs/migrating-from-openclaw.md) | Import persona, memory, skills, bots and schedules |
  104. | [Access Profiles](docs/access-profiles.md) | Approvals, sandbox, network and filesystem policy |
  105. | [Security Guide](docs/security-guide.md) | Threat model, guardrails, sandboxing, credential storage |
  106. | [Self-Hosting](docs/self-hosting.md) | Linux server, Docker and remote access |
  107. | [Development](docs/development.md) | Build from source and run the tests |
  108. | [All docs](docs/index.md) · [Changelog](CHANGELOG.md) · [Release Notes 0.5.63](docs/release-notes-0.5.63.md) | |
  109. ## Community
  110. - **Chat:** [Discord](https://discord.gg/UjykKwjhRC): #help for questions, #show-and-tell for what you built, #contributors for working on CoWork OS
  111. - **Questions and ideas:** [GitHub Discussions](https://github.com/CoWork-OS/CoWork-OS/discussions)
  112. - **Bugs and requests:** [Issues](https://github.com/CoWork-OS/CoWork-OS/issues). We reply within a day.
  113. - **Contribute:** start with a [good first issue](https://github.com/CoWork-OS/CoWork-OS/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and read [CONTRIBUTING.md](CONTRIBUTING.md).
  114. - **Read Chinese?** [`i18n/README.zh-CN.md`](i18n/README.zh-CN.md) needs a native-speaker review: see [#635](https://github.com/CoWork-OS/CoWork-OS/issues/635).
  115. - **Security reports:** [SECURITY.md](SECURITY.md)
  116. <!-- COWORK_PUBLIC_ADOPTION_STATS_START -->
  117. ### Public Adoption Signals
  118. | Signal | Current | All time |
  119. |---|---:|---:|
  120. | GitHub stars | 553 | n/a |
  121. | GitHub forks | 101 | n/a |
  122. | Installer/server downloads | 3,560 | 3,560 |
  123. | Download delta | +52 | n/a |
  124. | npm downloads | 280 (last week) | 10,986 |
  125. | GitHub views, last 14-ish days | 1,621 total / 846 unique | n/a |
  126. | GitHub clones, last 14-ish days | 4,494 total / 763 unique | n/a |
  127. Generated 2026-11-18T11:36:37.054Z. 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](docs/public-adoption-stats.md).
  128. <!-- COWORK_PUBLIC_ADOPTION_STATS_END -->
  129. ## License
  130. MIT License. See [LICENSE](LICENSE).
  131. ---
  132. <sub>"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.</sub>
  133. osai-verify: b359fb38a6b6ca5e28d0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.