open-computer-use

Overview

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. The project was inspired by OpenAI's Codex Computer Use and builds on Accessibility for non-intrusive CUA.

Key Features

• Open-source Computer Use service exposed as an MCP server for AI agents and MCP clients.
• Runs Computer Use across macOS, Linux, and Windows.
• Inspired by Codex Computer Use and built on Accessibility for non-intrusive CUA.
• The npm package provides open-computer-use and the short ocu CLI alias.
• Built-in installers support Codex, Claude Code, Gemini CLI, opencode, and DeepSeek Harness MCP setups.
• Includes ocu js for one-off JavaScript evaluation and ocu repl for a persistent interactive session.

Use Cases

• Connect an AI agent or MCP client to run Computer Use actions on desktop applications.
• Install into Codex App, Codex CLI, Gemini CLI, Claude Code, opencode, or DeepSeek Harness for agent-driven desktop automation.
• Use ocu js or ocu repl to script JavaScript automation with cua bindings.
• On macOS, find controls by text or role without taking a screenshot using targeted query.

Getting Started

• Install globally with npm i -g open-computer-use.
• On macOS, run open-computer-use or ocu once, then grant Accessibility and Screen Recording.
• Install into Codex with open-computer-use install-codex-mcp, or add the MCP server manually with command open-computer-use and args mcp.
• Install the skill with npx skills add iFurySt/open-computer-use -g -a codex --skill open-computer-use -y.
• Run open-computer-use doctor to check permissions.

Deployment & Requirements

• macOS runtime requires macOS 14.0 or later.
• The npm launcher requires Node.js 18 or newer.
• macOS requires Accessibility and Screen Recording permissions; Windows and Linux do not need this step.

Before You Adopt

• License: MIT. Review its terms before using, modifying, or distributing the project.
• The macOS runtime has a minimum OS requirement of macOS 14.0.
• The npm launcher depends on Node.js 18 or newer.
• Windows and Linux do not require the macOS permission step.
• Missing permissions can still exit with code 0, so permission status needs separate verification.
• Permission diagnostics do not prove an operation succeeded, and permission changes may require a process restart.