iFurySt /open-computer-use

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

★ 2,979⑂ 276👁 6⑃ 145● 31▤ 55
SwiftMITCreated 2026-04-17
Download: v1.1.4v1.1.4 ↓1.1.42026-11-07
+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

 Ins

Top issues

Latest release

v1.1.4 v1.1.4 2026-11-07
What'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

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