CoWork OS

Rent the model. Own everything else. Free, open-source AI app for real work.

1# CoWork OS

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Stars: 511
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install CoWork OS?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does CoWork OS need an API key?

No required environment variable is listed on this record.

What transport does CoWork OS use?

CoWork OS runs locally over stdio.

When was CoWork OS last checked?

Last checked 2026-10-27. Rent the model. Own everything else. Free, open-source AI app for real work.

From the publisher

Documentation

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.


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.

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 [email protected].

Getting started

Open CoWork OS. On macOS the first start may ask for the cowork-os Safe Storage keychain item; click Always Allow.
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.
Describe a task, for example "make a spreadsheet of my last ten invoices from ~/Downloads", or pick one from the use-case gallery.
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

Chat: Discord: #help for questions, #show-and-tell for what you built, #contributors for working on CoWork OS
Questions and ideas: GitHub Discussions
Bugs and requests: Issues. We reply within a day.
Contribute: start with a good first issue and read CONTRIBUTING.md.
Read Chinese? README.zh-CN.md needs a native-speaker review: see #635.
Security reports: SECURITY.md

Public Adoption Signals

Signal	Current	All time
GitHub stars	511	n/a
GitHub forks	93	n/a
Installer/server downloads	2,160	2,160
Download delta	+58	n/a
npm downloads	350 (last week)	9,933
GitHub views, last 14-ish days	839 total / 497 unique	n/a
GitHub clones, last 14-ish days	32,744 total / 1,725 unique	n/a

Generated 2026-10-26T08:51:09.381Z. 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

CoWork OS

CoWork-OS511starsClaim this server

Rent the model. Own everything else. Free, open-source AI app for real work.

Communication

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# CoWork OS

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Stars: 511
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install CoWork OS?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does CoWork OS need an API key?

No required environment variable is listed on this record.

What transport does CoWork OS use?

CoWork OS runs locally over stdio.

When was CoWork OS last checked?

Last checked 2026-10-27. Rent the model. Own everything else. Free, open-source AI app for real work.

From the publisher

Documentation

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.


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.

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 [email protected].

Getting started

Open CoWork OS. On macOS the first start may ask for the cowork-os Safe Storage keychain item; click Always Allow.
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.
Describe a task, for example "make a spreadsheet of my last ten invoices from ~/Downloads", or pick one from the use-case gallery.
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

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

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

Chat: Discord: #help for questions, #show-and-tell for what you built, #contributors for working on CoWork OS
Questions and ideas: GitHub Discussions
Bugs and requests: Issues. We reply within a day.
Contribute: start with a good first issue and read CONTRIBUTING.md.
Read Chinese? README.zh-CN.md needs a native-speaker review: see #635.
Security reports: SECURITY.md

Public Adoption Signals

Signal	Current	All time
GitHub stars	511	n/a
GitHub forks	93	n/a
Installer/server downloads	2,160	2,160
Download delta	+58	n/a
npm downloads	350 (last week)	9,933
GitHub views, last 14-ish days	839 total / 497 unique	n/a
GitHub clones, last 14-ish days	32,744 total / 1,725 unique	n/a

License

MIT License. See LICENSE.