Об этом проекте
# open-computer-use
`open-computer-use` — это открытый сервис `Computer Use`, обёрнутый в `MCP` (Model Context Protocol). Любой ИИ-агент или MCP-клиент может использовать его для запуска Computer Use на macOS, Linux и Windows.
Этот проект был вдохновлён [Codex Computer Use](https://openai.com/index/codex-for-almost-everything/) от OpenAI. Он продемонстрировал, что неинтрузивный CUA (Computer Use Agent) можно построить поверх API доступности, поэтому данный проект предоставляет открытую реализацию.
## Демонстрации
- **Codex App и Codex CLI**: используются как Computer Use в Codex App и Codex CLI, соответствуя официальному опыту.
- **Gemini CLI**: подключается к `open-computer-use` через MCP и выполняет полный набор действий Computer Use.
- **Linux**: работает на Linux.
## Быстрый старт
```bash
npm i -g open-computer-use
```
Пакет npm также предоставляет `ocu` в качестве короткого псевдонима CLI.
> **Важно**: среда выполнения для macOS требует macOS 14.0 или новее.
**На macOS запустите его один раз и предоставьте разрешения `Accessibility` и `Screen Recording`. В Windows и Linux этот шаг не нужен.**
```bash
open-computer-use
# или
ocu
```
Перед использованием установите его в своего агента:
```bash
# Установка в Codex путём записи в ~/.codex/config.toml
open-computer-use install-codex-mcp
```
Или добавьте его в свой клиент вручную:
```json
{
"mcpServers": {
"open-computer-use": {
"command": "open-computer-use",
"args": ["mcp"]
}
}
}
```
## Навык
Установите навык напрямую:
```bash
# Установка для 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'
```
Установка для Claude Code:
```bash
npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y
```
Обновление существующей глобальной установки, включая установку для Codex, созданную выше:
```bash
npx skills update open-computer-use -g -y
```
Вы также можете вручную скачать и установить [навык `open-computer-use`](./skills/open-computer-use).
## Дополнительные команды
Помимо JSON-конфигурации MCP выше, вы также можете использовать встроенные команды:
```bash
# Установка в Codex путём записи в ~/.codex/config.toml
open-computer-use install-codex-mcp
ocu install-codex-mcp
# Установка в качестве плагина Codex, в основном для Codex App
open-computer-use install-codex-plugin
# Установка в Claude Code путём записи в ~/.claude.json
open-computer-use install-claude-mcp
# Установка в Gemini CLI для текущего проекта путём записи в ./.gemini/settings.json
open-computer-use install-gemini-mcp
# Установка в пользовательскую конфигурацию Gemini CLI вместо этого
open-computer-use install-gemini-mcp --scope user
# Установка в opencode путём записи в ~/.config/opencode/opencode.json (или активный файл конфигурации)
open-computer-use install-opencode-mcp
# Установка через общий путь совместимости MCP в DeepSeek Harness
open-computer-use install-dsh-mcp
./scripts/install-dsh-mcp.sh --profile web --no-hook
# Вызов одного инструмента Computer Use и вывод результата в стиле JSON MCP
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'
# Проверка доступности среды выполнения code-first
ocu capabilities
ocu capabilities --json
# Запуск одной оценки JavaScript из аргумента, stdin или файла
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
# Сохранение привязок JavaScript и cua для текущей сессии терминала
ocu repl
# Запуск последовательности в одном процессе, чтобы состояние 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
# Проверка разрешений; онбординг открывается только когда чего-то не хватает
open-computer-use doctor
# Запуск локальной проверки из исходного чекаута
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
# Показать справку
open-computer-use -h
ocu -h
```
`ocu js` закрывает свой JavaScript Worker и дочерний нативный процесс MCP после одной оценки. `ocu repl` сохраняет их для текущей сессии терминала до `.exit`, Ctrl-D или завершения; `.reset` очищает его привязки. На macOS отдельный скрытый агент разрешений `Open Computer Use.app` может оставаться резидентным, чтобы последующие команды переиспользовали ту же идентичность разрешений. `ocu mcp` продолжает предоставлять нативную поверхность совместимости из девяти инструментов.
Сам лаунчер npm в настоящее время требует Node.js 18 или новее. Его справка всегда перечисляет `js` / `repl`, а `ocu capabilities --json` сообщает, доступны ли Node, адаптер/ядро REPL и нативная среда выполнения. После запуска он переиспользует текущий исполняемый файл Node вместо поиска другого `node` в PATH.
## Движение курсора
Cursor Motion — это открытая система движения курсора для macOS, основанная на публичной информации, которой поделились участники команды Software.Inc. Вы можете скачать приложение со [страницы релизов](https://github.com/iFurySt/open-codex-computer-use/releases).
## История звёзд
См. [график истории звёзд](https://www.star-history.com/?repos=iFurySt%2Fopen-codex-computer-use&type=date&legend=top-left), чтобы узнать о популярности проекта во времени.
## Лицензия
[MIT](./LICENSE).
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.