andrewyng /openworker

★ 19,364⑂ 2,761👁 128⑃ 623● 280▤ 9
PythonMITCreated 2026-07-20openworker.com
Download: v0.3.1v0.3.1 ↓0.3.12026-10-05
+101
Daily
+478
Weekly
+863
Monthly
19,364
stars
2,761
forks
128
watchers
623
prs
280
issues
9
releases

README

OpenWorker

A Desktop App for everyday work.A Harness SDK to power your AI ideas.

openworker.com · Desktop App · Harness SDK · Issues



Use the OpenWorker Desktop App to research, write, review code, and carry out tasks across the tools you already use. Or build your own agentic desktop and web apps with the OpenWorker Harness SDK.

Bring your choice of cloud or local models. Set permissions for your agents and decide which actions need your approval.

 This README mainly covers the OpenWorker Desktop App. For SDK setup, examples and architecture, see the OpenWorker Harness SDK README.

 Use the OpenWorker Desktop App

An AI coworker for your everyday work. Go from a request to a prepared brief, an organized folder, or a reviewed pull request.

It runs on your machine. Bring your own model key or run locally with Ollama, and choose which integrations it can access. Commands can run inside an NVIDIA OpenShell sandbox. See Governed by design for its approval and safety controls.





⬇ macOS (Apple Silicon)
macOS 12+ · signed & notarized · auto-updates

⬇ Windows 10/11 (x64)
builds are not yet code-signed, so SmartScreen will warn; signing is in progress

Open the app, add a model key (or point it at Ollama), and ask for something real.

The OpenWorker Desktop App is in open beta and supports automatic updates. Issues welcome as we polish rough edges.



 Build agentic apps using OpenWorker Harness SDK

Bring agentic capabilities to your own desktop app, web app or local utility. Build the product experience while OpenWorker handles the agent loop, tool calls, approvals, streaming and durable sessions.

Use the TypeScript SDK from npm, or embed the Rust engine in your application. Start with one agent. Add sub-agents, teams, OpenShell sandboxing and observability as your application grows.

sh
npm install @openworkerai/harness-sdk


Explore the Harness SDK → ·
Desktop guide ·
Web guide ·
Build with Codex or Claude Code

The rest of this README focuses on the OpenWorker Desktop App. For SDK documentation, continue with the Harness SDK README.





 What you can do with the Desktop App

| Your work | How OpenWorker helps |
|---|---|
| Research and create | Turn notes, files and research into briefs, documents, spreadsheets and reports. |
| Review security risks | Scan code and dependencies, review cloud configuration, and investigate incidents. Proposed code fixes are re-scanned and reviewed before approval. |
| Work across your tools | Bring together GitHub, Slack, email, calendars and other connected apps. Add tools through MCP. |
| Delegate from Slack | Mention @OpenWorker; the task runs on your desktop and the reply returns to the thread. |
| Automate recurring work | Schedule morning briefs, weekly reports and other repeatable tasks, with transcripts to review. |
| Choose your model | Connect a cloud provider or use a local model through Ollama and other compatible servers. |
| Control agent actions | Review approvals, inspect recorded actions

Top issues

Latest release

v0.3.1 v0.3.1 2026-10-05
OpenWorker inside OpenShell. The CLI is published as an image, ghcr.io/andrewyng/openworker, so you can run a coworker fully inside an NVIDIA OpenShell sandbox with one command. When a site is blocked, the coworker asks and waits while you allow it.

OpenShell 0.1.2. The desktop app's OpenShell option now works with OpenShell 0.1.2. If you are on OpenShell 0.0.x, upgrade OpenShell first. On a Mac, Docker Desktop's host networking must be on; Settings checks this and tells you. "Allow everything" is no longer offered with OpenShell.

 What's Changed
 Sandbox improvements - WebSearch follow

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON