프로젝트 소개
# open-computer-use
`open-computer-use`는 `MCP`(Model Context Protocol)로 래핑된 오픈소스 `Computer Use` 서비스입니다. 모든 AI 에이전트 또는 MCP 클라이언트가 이를 사용하여 macOS, Linux, Windows에서 Computer Use를 실행할 수 있습니다.
이 프로젝트는 OpenAI의 [Codex Computer Use](https://openai.com/index/codex-for-almost-everything/)에서 영감을 받았습니다. 비침투적 CUA(Computer Use Agent)가 접근성 API 위에 구축될 수 있음을 보여주었기에, 이 프로젝트는 오픈소스 구현을 제공합니다.
## 데모
- **Codex App 및 Codex CLI**: Codex App과 Codex CLI에서 Computer Use로 사용되며, 공식 경험과 일치합니다.
- **Gemini CLI**: MCP를 통해 `open-computer-use`에 연결하고 전체 Computer Use 작업을 실행합니다.
- **Linux**: Linux에서 실행됩니다.
## 빠른 시작
```bash
npm i -g open-computer-use
```
npm 패키지는 짧은 CLI 별칭으로 `ocu`도 노출합니다.
> **중요**: macOS 런타임은 macOS 14.0 이상이 필요합니다.
**macOS에서는 한 번 실행하고 `Accessibility`와 `Screen Recording`을 부여하세요. Windows와 Linux는 이 단계가 필요하지 않습니다.**
```bash
open-computer-use
# 또는
ocu
```
사용하기 전에 에이전트에 설치하세요:
```bash
# ~/.codex/config.toml에 기록하여 Codex에 설치
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)을 수동으로 다운로드하여 설치할 수도 있습니다.
## 추가 명령어
위의 MCP JSON 구성 외에도 내장 명령어를 사용할 수 있습니다:
```bash
# ~/.codex/config.toml에 기록하여 Codex에 설치
open-computer-use install-codex-mcp
ocu install-codex-mcp
# 주로 Codex App용으로 Codex 플러그인으로 설치
open-computer-use install-codex-plugin
# ~/.claude.json에 기록하여 Claude Code에 설치
open-computer-use install-claude-mcp
# ./.gemini/settings.json에 기록하여 현재 프로젝트의 Gemini CLI에 설치
open-computer-use install-gemini-mcp
# 대신 Gemini CLI 사용자 구성에 설치
open-computer-use install-gemini-mcp --scope user
# ~/.config/opencode/opencode.json(또는 활성 구성 파일)에 기록하여 opencode에 설치
open-computer-use install-opencode-mcp
# DeepSeek Harness의 일반 MCP 호환 경로를 통해 설치
open-computer-use install-dsh-mcp
./scripts/install-dsh-mcp.sh --profile web --no-hook
# 단일 Computer Use 도구를 호출하고 MCP 스타일 JSON 결과를 출력
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'
# 코드 우선 런타임 가용성 검사
ocu capabilities
ocu capabilities --json
# 인수, stdin 또는 파일에서 하나의 JavaScript 평가 실행
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` 권한 에이전트가 상주하여 이후 명령이 동일한 권한 ID를 재사용할 수 있습니다. `ocu mcp`는 계속해서 네이티브 9개 도구 호환 표면을 노출합니다.
npm 런처 자체는 현재 Node.js 18 이상이 필요합니다. 도움말에는 항상 `js` / `repl`이 나열되며, `ocu capabilities --json`은 Node, REPL 어댑터/커널 및 네이티브 런타임이 사용 가능한지 보고합니다. 시작되면 PATH에서 다른 `node`를 찾는 대신 현재 Node 실행 파일을 재사용합니다.
## 커서 모션
커서 모션은 Software.Inc 팀 구성원이 공유한 공개 정보를 기반으로 한 macOS용 오픈소스 커서 모션 시스템입니다. [Releases 페이지](https://github.com/iFurySt/open-codex-computer-use/releases)에서 앱을 다운로드할 수 있습니다.
## 스타 히스토리
시간 경과에 따른 프로젝트 인기도는 [Star History Chart](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.