Sobre el proyecto

# open-computer-use `open-computer-use` es un servicio `Computer Use` de código abierto empaquetado como `MCP` (Model Context Protocol). Cualquier agente de IA o cliente MCP puede usarlo para ejecutar Computer Use en macOS, Linux y Windows. Este proyecto se inspiró en [Codex Computer Use](https://openai.com/index/codex-for-almost-everything/) de OpenAI. Demostró que se puede construir un CUA (Computer Use Agent) no intrusivo sobre las API de accesibilidad, por lo que este proyecto proporciona una implementación de código abierto. ## Demos - **Codex App y Codex CLI**: Se usa como Computer Use en Codex App y Codex CLI, igualando la experiencia oficial. - **Gemini CLI**: Se conecta a `open-computer-use` a través de MCP y ejecuta acciones completas de Computer Use. - **Linux**: Se ejecuta en Linux. ## Inicio rápido ```bash npm i -g open-computer-use ``` El paquete npm también expone `ocu` como alias corto de CLI. > **Importante**: El runtime de macOS requiere macOS 14.0 o posterior. **En macOS, ejecútalo una vez y concede `Accessibility` y `Screen Recording`. Windows y Linux no necesitan este paso.** ```bash open-computer-use # o ocu ``` Antes de usarlo, instálalo en tu agente: ```bash # Instalar en Codex escribiendo en ~/.codex/config.toml open-computer-use install-codex-mcp ``` O añádelo manualmente a tu propio cliente: ```json { "mcpServers": { "open-computer-use": { "command": "open-computer-use", "args": ["mcp"] } } } ``` ## Skill Instala la skill directamente: ```bash # Instalar para Codex npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y npx skills ls -g -a codex | rg 'open-computer-use' ``` Instalar para Claude Code: ```bash npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y ``` Actualiza una instalación global existente, incluida la instalación de Codex creada arriba: ```bash npx skills update open-computer-use -g -y ``` También puedes descargar e instalar manualmente la skill [`open-computer-use`](./skills/open-computer-use). ## Más comandos Además de la configuración JSON de MCP anterior, también puedes usar los comandos integrados: ```bash # Instalar en Codex escribiendo en ~/.codex/config.toml open-computer-use install-codex-mcp ocu install-codex-mcp # Instalar como plugin de Codex, principalmente para Codex App open-computer-use install-codex-plugin # Instalar en Claude Code escribiendo en ~/.claude.json open-computer-use install-claude-mcp # Instalar en Gemini CLI para el proyecto actual escribiendo en ./.gemini/settings.json open-computer-use install-gemini-mcp # Instalar en la configuración de usuario de Gemini CLI en su lugar open-computer-use install-gemini-mcp --scope user # Instalar en opencode escribiendo en ~/.config/opencode/opencode.json (o el archivo de configuración activo) open-computer-use install-opencode-mcp # Instalar a través de la ruta de compatibilidad MCP genérica de DeepSeek Harness open-computer-use install-dsh-mcp ./scripts/install-dsh-mcp.sh --profile web --no-hook # Llamar a una sola herramienta de Computer Use e imprimir el resultado JSON estilo MCP open-computer-use call list_apps ocu call list_apps open-computer-use call get_app_state --args '{"app":"TextEdit"}' # Inspeccionar la disponibilidad del runtime code-first ocu capabilities ocu capabilities --json # Ejecutar una evaluación de JavaScript, desde un argumento, stdin o un archivo ocu js 'var apps = await cua.listApps({ emit: false }); nodeRepl.write(apps)' printf '%s' 'nodeRepl.write(6 * 7)' | ocu js - ocu js --file ./automation.mjs # Mantener los bindings de JavaScript y cua para la sesión de terminal actual ocu repl # Ejecutar una secuencia en un solo proceso para que se pueda reutilizar el estado de element_index 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 # Comprobar permisos; el onboarding solo se abre cuando falta algo open-computer-use doctor # Ejecutar validación local desde un checkout del código fuente make smoke OPEN_COMPUTER_USE_STRESS_LOOPS=20 make stress make agent-smoke make agent-smoke SCENARIO=fixture-full node ./scripts/run-agent-smoke-tests.mjs --agents=claude,codex --command=open-computer-use node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=claude,codex --command=open-computer-use node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=claude,codex --command=open-computer-use OPEN_COMPUTER_USE_HERMES_PROVIDER=anthropic OPEN_COMPUTER_USE_HERMES_MODEL=claude-opus-4-20250514 make agent-smoke AGENTS=hermes SCENARIO=fixture-full node ./scripts/run-agent-smoke-tests.mjs --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514 node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514 node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514 --hermes-max-turns=12 # Mostrar ayuda open-computer-use -h ocu -h ``` `ocu js` cierra su JavaScript Worker y su proceso hijo MCP nativo tras una evaluación. `ocu repl` los mantiene para la sesión de terminal actual hasta `.exit`, Ctrl-D o terminación; `.reset` limpia sus bindings. En macOS, el agente de permisos oculto separado `Open Computer Use.app` puede permanecer residente para que los comandos posteriores reutilicen la misma identidad de permisos. `ocu mcp` sigue exponiendo la superficie de compatibilidad nativa de nueve herramientas. El lanzador de npm en sí requiere actualmente Node.js 18 o posterior. Su ayuda siempre lista `js` / `repl`, mientras que `ocu capabilities --json` informa si Node, el adaptador/kernel de REPL y el runtime nativo están disponibles. Una vez iniciado, reutiliza el ejecutable de Node actual en lugar de buscar otro `node` en PATH. ## Cursor Motion Cursor Motion es un sistema de movimiento del cursor de código abierto para macOS, basado en información pública compartida por miembros del equipo de Software.Inc. Puedes descargar la app desde la [página de Releases](https://github.com/iFurySt/open-codex-computer-use/releases). ## Star History Consulta el [Star History Chart](https://www.star-history.com/?repos=iFurySt%2Fopen-codex-computer-use&type=date&legend=top-left) para ver la popularidad del proyecto a lo largo del tiempo. ## Licencia [MIT](./LICENSE).