open-codex-computer-use
starsforks
How to install open-codex-computer-use?
ifuryst/open-codex-computer-use
$git clone https://github.com/iFurySt/open-codex-computer-use> [!TIP] > Interested in Browser Use? Check out open-browser-use.
README.md
| 1 | # open-computer-use |
| 2 | |
| 3 | [](./README.md) |
| 4 | [](./README.zh-CN.md) |
| 5 | [](https://github.com/iFurySt/open-codex-computer-use/releases) |
| 6 | [](https://deepwiki.com/iFurySt/open-codex-computer-use) |
| 7 | <a href="https://llmapis.com?source=https%3A%2F%2Fgithub.com%2FiFurySt%2Fopen-codex-computer-use" target="_blank"><img src="https://llmapis.com/api/badge/iFurySt/open-codex-computer-use" alt="LLMAPIS" width="20" /></a> |
| 8 | |
| 9 | > [!TIP] |
| 10 | > Interested in Browser Use? Check out [open-browser-use](https://github.com/iFurySt/open-codex-browser-use). |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | `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. |
| 15 | |
| 16 | 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. |
| 17 | |
| 18 | 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. |
| 19 | |
| 20 | ## Demos |
| 21 | |
| 22 | ### Codex App and Codex CLI |
| 23 | |
| 24 | [](https://youtu.be/2s6aVpGiwaQ) |
| 25 | |
| 26 | <sub><em>`open-computer-use` used as Computer Use in Codex App and Codex CLI, matching the official experience.</em></sub> |
| 27 | |
| 28 | ### Gemini CLI |
| 29 | |
| 30 | https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d |
| 31 | |
| 32 | <sub><em>Gemini CLI connects to `open-computer-use` through MCP and runs full Computer Use actions.</em></sub> |
| 33 | |
| 34 | ### Linux |
| 35 | |
| 36 | https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66 |
| 37 | |
| 38 | <sub><em>`open-computer-use` running on Linux.</em></sub> |
| 39 | |
| 40 | ## Quick Start |
| 41 | |
| 42 | ```bash |
| 43 | npm i -g open-computer-use |
| 44 | ``` |
| 45 | |
| 46 | The npm package also exposes `ocu` as the short CLI alias. |
| 47 | |
| 48 | > [!IMPORTANT] |
| 49 | > The macOS runtime requires macOS 14.0 or later. |
| 50 | |
| 51 | **On macOS, run it once and grant `Accessibility` and `Screen Recording`. Windows and Linux do not need this step.** |
| 52 | |
| 53 | ```bash |
| 54 | open-computer-use |
| 55 | # or |
| 56 | ocu |
| 57 | ``` |
| 58 | |
| 59 | Before using it, install it into your agent: |
| 60 | |
| 61 | ```bash |
| 62 | # Install into Codex by writing to ~/.codex/config.toml |
| 63 | open-computer-use install-codex-mcp |
| 64 | ``` |
| 65 | |
| 66 | Or add it to your own client manually: |
| 67 | |
| 68 | ```json |
| 69 | { |
| 70 | "mcpServers": { |
| 71 | "open-computer-use": { |
| 72 | "command": "open-computer-use", |
| 73 | "args": ["mcp"] |
| 74 | } |
| 75 | } |
| 76 | } |
| 77 | ``` |
| 78 | |
| 79 | ### Skill |
| 80 | |
| 81 | Install the skill directly: |
| 82 | |
| 83 | ```bash |
| 84 | # Install for Codex |
| 85 | npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y |
| 86 | npx skills ls -g -a codex | rg 'open-computer-use' |
| 87 | ``` |
| 88 | |
| 89 | Install for Claude Code: |
| 90 | |
| 91 | ```bash |
| 92 | npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y |
| 93 | ``` |
| 94 | |
| 95 | Update an existing global install, including the Codex install created above: |
| 96 | |
| 97 | ```bash |
| 98 | npx skills update open-computer-use -g -y |
| 99 | ``` |
| 100 | |
| 101 | You can also manually download and install the |
| 102 | [`open-computer-use` skill](./skills/open-computer-use). |
| 103 | |
| 104 | ## More |
| 105 | |
| 106 | Besides the MCP JSON config above, you can also use the built-in commands: |
| 107 | |
| 108 | ```bash |
| 109 | # Install into Codex by writing to ~/.codex/config.toml |
| 110 | open-computer-use install-codex-mcp |
| 111 | ocu install-codex-mcp |
| 112 | |
| 113 | # Install as a Codex plugin, mainly for Codex App |
| 114 | open-computer-use install-codex-plugin |
| 115 | |
| 116 | # Install into Claude Code by writing to ~/.claude.json |
| 117 | open-computer-use install-claude-mcp |
| 118 | |
| 119 | # Install into Gemini CLI for the current project by writing to ./.gemini/settings.json |
| 120 | open-computer-use install-gemini-mcp |
| 121 | |
| 122 | # Install into Gemini CLI user config |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
