Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ifuryst--open-computer-use/badge.svg)](/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

i

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.

  1. # open-computer-use
  2. [![English](https://img.shields.io/badge/English-Click-yellow)](./README.md)
  3. [![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](./README.zh-CN.md)
  4. [![Release](https://img.shields.io/github/v/release/iFurySt/open-computer-use)](https://github.com/iFurySt/open-computer-use/releases)
  5. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iFurySt/open-computer-use)
  6. <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>
  7. > [!TIP]
  8. > Interested in Browser Use? Check out [open-browser-use](https://github.com/iFurySt/open-codex-browser-use).
  9. ---
  10. `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.
  11. 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.
  12. 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.
  13. ## Demos
  14. ### Codex App and Codex CLI
  15. [![Open Computer Use custom demo cover](./docs/generated/readme-assets/open-computer-use-demo-cover.png)](https://youtu.be/2s6aVpGiwaQ)
  16. <sub><em>`open-computer-use` used as Computer Use in Codex App and Codex CLI, matching the official experience.</em></sub>
  17. ### Gemini CLI
  18. https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d
  19. <sub><em>Gemini CLI connects to `open-computer-use` through MCP and runs full Computer Use actions.</em></sub>
  20. ### Linux
  21. https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66
  22. <sub><em>`open-computer-use` running on Linux.</em></sub>
  23. ### Locked Use
  24. 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.
  25. ![Open Computer Use Locked Use screen](./docs/assets/ocu-locked-use.webp)
  26. See the [Locked Use guide](docs/locked-use.en.md) for setup, installed components, and permissions
  27. ## Quick Start
  28. ```bash
  29. npm i -g open-computer-use
  30. ```
  31. The npm package also exposes `ocu` as the short CLI alias.
  32. > [!IMPORTANT]
  33. > The macOS runtime requires macOS 14.0 or later.
  34. **On macOS, run it once and grant `Accessibility` and `Screen Recording`. Windows and Linux do not need this step.**
  35. ```bash
  36. open-computer-use
  37. # or
  38. ocu
  39. ```
  40. Before using it, install it into your agent:
  41. ```bash
  42. # Install into Codex by writing to ~/.codex/config.toml
  43. open-computer-use install-codex-mcp
  44. ocu install-codex-mcp
  45. ```
  46. Or add it to your own client manually:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "open-computer-use": {
  51. "command": "open-computer-use",
  52. "args": ["mcp"]
  53. }
  54. }
  55. }
  56. ```
  57. ### Skill
  58. Install the skill directly:
  59. ```bash
  60. # Install for Codex
  61. npx skills add iFurySt/open-computer-use -g -a codex --skill open-computer-use -y
  62. npx skills ls -g -a codex | rg 'open-computer-use'
  63. ```
  64. Install for Claude Code:
  65. ```bash
  66. npx skills add iFurySt/open-computer-use -g -a claude-code --skill open-computer-use -y
  67. ```
  68. Update an existing global install, including the Codex install created above:
  69. ```bash
  70. npx skills update open-computer-use -g -y
  71. ```
  72. You can also manually download and install the
  73. [`open-computer-use` skill](./skills/open-computer-use).
  74. ## More
  75. Besides the MCP JSON config above, you can also use the built-in commands:
  76. ```bash
  77. # Install into Codex by writing to ~/.codex/config.toml
  78. open-computer-use install-codex-mcp
  79. # Install as a Codex plugin, mainly for Codex App
  80. open-computer-use install-codex-plugin
  81. # Install into Claude Code by writing to ~/.claude.json
  82. open-computer-use install-claude-mcp
  83. # Install into Gemini CLI for the current project by writing to ./.gemini/settings.json
  84. open-computer-use install-gemini-mcp
  85. # Install into Gemini CLI user config instead
  86. open-computer-use install-gemini-mcp --scope user
  87. # Install into opencode by writing to ~/.config/opencode/opencode.json (or the active config file)
  88. open-computer-use install-opencode-mcp
  89. # Call a single Computer Use tool and print the MCP-style JSON result
  90. open-computer-use call list_apps
  91. ocu call list_apps
  92. open-computer-use call get_app_state --args '{"app":"TextEdit"}'
  93. # Run a sequence in one process so element_index state can be reused
  94. # Sequence runs sleep 1s between successful operations by default
  95. open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
  96. open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5
  97. # Check permissions; onboarding only opens when something is missing
  98. open-computer-use doctor
  99. # macOS: query permission JSON without opening onboarding
  100. ocu doctor --json
  101. # Show help
  102. open-computer-use -h
  103. ocu -h
  104. ```
  105. ## Global Configuration
  106. `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.
  107. ## Star History
  108. <a href="https://www.star-history.com/?repos=iFurySt%2Fopen-computer-use&type=date&legend=top-left">
  109. <picture>
  110. <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" />
  111. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ifuryst/open-computer-use&type=date&legend=top-left" />
  112. <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" />
  113. </picture>
  114. </a>
  115. ## License
  116. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.