BackgroundComputerUse
macOS에서 사용자 포인터를 빼앗지 않고, 네이티브 앱과 브라우저 창, 다중 창 데스크톱 워크플로를 제어하는 로컬 computer-use 런타임.
한 줄 요약
actuallyepic/background-computer-use는 Swift 기반의 macOS 전용 computer-use API로, loopback HTTP 서버와 직접 Swift 패키지 API를 함께 제공한다.
핵심 특징
- 비침습적 실행: 화면 전체를 점거하는 방식이 아니라 백그라운드에서 앱을 조작하는 방향을 지향한다.
- 로컬 HTTP API:
GET /v1/bootstrap,GET /v1/routes,POST /v1/list_apps,POST /v1/list_windows같은 엔드포인트로 제어한다. - 시각 + 접근성 혼합: screenshot, Accessibility tree, window state를 함께 읽고 클릭/스크롤/타이핑/키 입력/드래그/리사이즈를 수행한다.
- Swift 패키지 API: HTTP 서버 없이
BackgroundComputerUseRuntime()를 직접 사용할 수 있다. - 앱 서명 필수: macOS 권한은 서명된 앱 번들에 붙으므로
./script/start.sh또는./script/build_and_run.sh run흐름을 권장한다.
운영 방식
./script/start.sh로 빌드 및 실행- 런타임 매니페스트에서 실제
baseURL확인 /v1/bootstrap으로 권한과 준비 상태 확인/v1/routes로 지원 액션 조회- 앱 목록/윈도우 상태를 읽고 액션 수행
- 작업 뒤 다시 화면 상태를 재검증
왜 중요한가
[[2026-03-25-claude-code-computer-use]]이후, 컴퓨터 유스는 단순 브라우저 자동화를 넘어 OS 네이티브 제어로 이동하고 있다.- 이 프로젝트는 “컴퓨터를 쓰는 에이전트”를 위해 백그라운드-first UX를 강하게 밀어붙인다는 점이 특징이다.
[[2026-04-27-macos-cua-repos-comparison]]에서 다뤘던 iFurySt/hyprcat/Coasty-AI 계열과 함께 보면, macOS CUA 생태계가 MCP 연동형, 백그라운드-first형, VM 격리형으로 빠르게 분화하고 있음을 볼 수 있다.
스냅샷 메타데이터
| 항목 | 값 |
|---|---|
| Repo | actuallyepic/background-computer-use |
| Stars | 216 |
| Forks | 23 |
| Language | Swift |
| License | MIT |
| Latest release | v0.1.0 |
| Release date | 2026-05-05 |
관련 노트
- 2026-04-27-macos-cua-repos-comparison — macOS CUA 생태계 비교
- 2026-03-25-claude-code-computer-use — Claude Code의 computer-use 기능
- 2026-05-06-trope-cua — Windows/macOS 백그라운드 computer-use 드라이버
- 2026-04-10-factory-droid-desktop-app — 컴퓨터 유스 기반 데스크톱 앱 사례