iFurySt /open-computer-use
👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
★ 2,979⑂ 276👁 6⑃ 145● 31▤ 55
+5
Daily
2,979
stars
276
forks
6
watchers
145
prs
31
issues
55
releases
README
open-computer-use
[!TIP]
Interested in Browser Use? Check out open-browser-use.
---
open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.
This project was inspired by OpenAI's Codex Computer Use. It showed that non-intrusive CUA can be built on top of Accessibility, so I decided to build an open-source version.
I started this repo with my harness template, a template for quickly spinning up AI-first projects. It has been one of our most useful workflows lately, especially for nearly 100% AI-generated projects. I also wrote a post about the methodology behind it.
Demos
Codex App and Codex CLI
open-computer-use used as Computer Use in Codex App and Codex CLI, matching the official experience.
Gemini CLI
https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d
Gemini CLI connects to open-computer-use through MCP and runs full Computer Use actions.
Linux
https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66
open-computer-use running on Linux.
Locked Use
Locked Use is now supported on macOS. OCU temporarily unlocks your Mac after it has been locked so the agent can continue working, with protective services such as a full-screen shield in place during use.
!Open Computer Use Locked Use screen
See the Locked Use guide for setup, installed components, and permissions
Quick Start
bash
npm i -g open-computer-use
The npm package also exposes ocu as the short CLI alias.
[!IMPORTANT]
The macOS runtime requires macOS 14.0 or later.
On macOS, run it once and grant Accessibility and Screen Recording. Windows and Linux do not need this step.
bash
open-computer-use
or
ocu
Before using it, install it into your agent:
bash
Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp
ocu install-codex-mcp
Or add it to your own client manually:
json
{
"mcpServers": {
"open-computer-use": {
"command": "open-computer-use",
"args": ["mcp"]
}
}
}
Skill
Install the skill directly:
bash
Install for Codex
npx skills add iFurySt/open-computer-use -g -a codex --skill open-computer-use -y
npx skills ls -g -a codex | rg 'open-computer-use'
Install for Claude Code:
bash
npx skills add iFurySt/open-computer-use -g -a claude-code --skill open-computer-use -y
Update an existing global install, including the Codex install created above:
bash
npx skills update open-computer-use -g -y
You can also manually download and install the
open-computer-use skill.
More
Besides the MCP JSON config above, you can also use the built-in commands:
bash
Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp
Install as a Codex plugin, mainly for Codex App
open-computer-use install-codex-plugin
Install into Claude Code by writing to ~/.claude.json
open-computer-use install-claude-mcp
InsTop issues
#53macOS: drag tool executes without error but performs no actual drag (window move / text selection)6 comments · 2026-08-05#57get_app_state/snapshot fail with 'Apple event error -10005: cgWindowNotFound' after logout+relogin (macOS 27 beta); fixed by reboot4 comments · 2026-08-25#91[Bug] Windows: coordinate click/drag post to the top-level HWND, not the child under the point; PostMessage failures (UIPI) reported as success2 comments · 2026-10-10#83[Bug] macOS 26 real-world findings on 0.3.5: wrong-window targeting, silent set_value, docs/version mismatch, and more2 comments · 2026-09-27#90[Bug] Windows: get_app_state screenshot uses CopyFromScreen, so a covered window returns the covering content (use PrintWindow PW_RENDERFULLCONTENT)1 comments · 2026-10-10#49windows上是不是用不了1 comments · 2026-07-28#142Locked Use fails when Karabiner-Elements is running (IOHIDManagerOpen returns kIOReturnExclusiveAccess)0 comments · 2026-11-01#98[Bug] Windows 1.0.0 scroll fallback rejects a visible target despite a fresh screenshot (repro for #97)0 comments · 2026-10-13
Latest release
v1.1.4 v1.1.4 2026-11-07What's Changed Fix Locked Use cleanup after idle timeout and Guardian reconnection so completed sessions can release protection and allow the next task. 158 Preserve visible controls and action buttons when large accessibility trees reach their node budget on macOS, Windows, and Linux. 145 Verify actual values after setting controls across platforms, including when action read-back is disabled; preserve whitespace and support clearing fields. 111 Full Changelog: https://github.com/iFurySt/open-computer-use/compare/v1.1.3...v1.1.4