open-computer-use
👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ifuryst/open-computer-use with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ifuryst/open-computer-use'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/ifuryst--open-computer-use)HTML
<a href="/listings/ifuryst--open-computer-use"><img src="/api/listings/ifuryst--open-computer-use/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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.**
open-computer-use # or ocu
Before using it, install it into your agent:
# Install into Codex by writing to ~/.codex/config.toml open-computer-use install-codex-mcp
Or add it to your own client manually:
{
"mcpServers": {
"open-computer-use": {
"command": "open-computer-use",
"args": ["mcp"]
}
}
}Skill
Install the skill directly:
# 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:
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:
npx skills update open-computer-use -g -y
You can also manually download and install the [`open-computer-use` skill](./skills/open-computer-use).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 173 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # open-computer-use
- [](./README.md)
- [](./README.zh-CN.md)
- [](https://github.com/iFurySt/open-computer-use/releases)
- [](https://deepwiki.com/iFurySt/open-computer-use)
- <a href="https://llmapis.com?source=https%3A%2F%2Fgithub.com%2FiFurySt%2Fopen-computer-use" target="_blank"><img src="https://llmapis.com/api/badge/iFurySt/open-computer-use" alt="LLMAPIS" width="20" /></a>
- > [!TIP]
- > Interested in Browser Use? Check out [open-browser-use](https://github.com/iFurySt/open-codex-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](https://openai.com/index/codex-for-almost-everything/). 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](https://github.com/iFurySt/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](https://www.ifuryst.com/blog/2026/speedrunning-the-ai-era/) about the methodology behind it.
- ## Demos
- ### Codex App and Codex CLI
- [](https://youtu.be/2s6aVpGiwaQ)
- <sub><em>`open-computer-use` used as Computer Use in Codex App and Codex CLI, matching the official experience.</em></sub>
- ### Gemini CLI
- https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d
- <sub><em>Gemini CLI connects to `open-computer-use` through MCP and runs full Computer Use actions.</em></sub>
- ### Linux
- https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66
- <sub><em>`open-computer-use` running on Linux.</em></sub>
- ### 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.
- 
- See the [Locked Use guide](docs/locked-use.en.md) 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](./skills/open-computer-use).
- ## 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
- # Install into Gemini CLI for the current project by writing to ./.gemini/settings.json
- open-computer-use install-gemini-mcp
- # Install into Gemini CLI user config instead
- open-computer-use install-gemini-mcp --scope user
- # Install into opencode by writing to ~/.config/opencode/opencode.json (or the active config file)
- open-computer-use install-opencode-mcp
- # Call a single Computer Use tool and print the MCP-style JSON result
- open-computer-use call list_apps
- ocu call list_apps
- open-computer-use call get_app_state --args '{"app":"TextEdit"}'
- # Run a sequence in one process so element_index state can be reused
- # Sequence runs sleep 1s between successful operations by default
- open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
- open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5
- # Check permissions; onboarding only opens when something is missing
- open-computer-use doctor
- # macOS: query permission JSON without opening onboarding
- ocu doctor --json
- # Show help
- open-computer-use -h
- ocu -h
- ```
- ## Global Configuration
- `ocu` supports global configuration starting with version 1.0.0 to accommodate different workflows and use cases. The default configuration file is `~/.config/ocu/config.json`. You can edit the file directly or use the `ocu config` subcommands. See the [configuration guide](docs/configuration.md) for details.
- ## Star History
- <a href="https://www.star-history.com/?repos=iFurySt%2Fopen-computer-use&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ifuryst/open-computer-use&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ifuryst/open-computer-use&type=date&legend=top-left" />
- <img alt="Star History Chart for open-computer-use" src="https://api.star-history.com/chart?repos=ifuryst/open-computer-use&type=date&legend=top-left" />
- </picture>
- </a>
- ## License
- [MIT](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.