LLM 에이전트에게 macOS 전체를 완전히 제어할 수 있는 가장 얇고 단순한 Python 하네스
중간맛 분석
macOS의 CGWindow, CGEvent, Accessibility , Apple Events, CDP(Browser Harness)를 하나의 지속적인 Python 프로세스로 통합한 에이전트 실행 환경입니다. see, key, type, click, ax, script 6개의 원시 명령어와 browser, Path, subprocess가 즉시 사용 가능하며, 앱별 전용 도구 없이도 모든 macOS 앱을 자동화할 수 있습니다. Codex나 Claude Code에 한 줄 프롬프트를 붙여넣으면 에이전트가 직접 설치·설정·검증까지 수행합니다. Python 3.12와 uv가 필요하며, macOS 전용입니다.
이런 레포예요
이럴 때 쓰면 좋아요
- LLM 에이전트가 macOS의 모든 앱을 앱별 전용 도구 없이 자동화해야 할 때
- 백그라운드 앱을 포어그라운드로 전환하지 않고 제어·스크린샷·입력을 처리해야 할 때
- Codex나 Claude Code 같은 에이전트에게 로컬 Mac 환경 전체를 제어 권한으로 부여하고 싶을 때
핵심 기능
대안 대비 차별점
앱별 전용 도구나 프레임워크 없이 raw macOS primitive만 노출해 LLM이 직접 Python 코드를 생성하며 범용 자동화를 수행하는 구조로, 기존 RPA·computer-use 도구 대비 래퍼 의존성이 없음
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- macOS
- Python 3.12
- uv
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/browser-use/macos-harness.git && cd macos-harness && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 에이전트(Codex/Claude Code)를 통한 자동 설치 — 아래 프롬프트를 에이전트에 붙여넣으세요:
# Codex 또는 Claude Code에 아래 텍스트를 붙여넣기
Install or upgrade macOS Harness from https://github.com/browser-use/macos-harness with uv using Python 3.12. Register the skill printed by `macos-harness skill`, then run `macos-harness doctor`. Explain any missing macOS permissions and ask before requesting them. Finally, verify the harness by capturing one already-running app without bringing it to the foreground.
- (수동) uv로 패키지 설치:
uv pip install --python 3.12 git+https://github.com/browser-use/macos-harness
- macOS 권한 및 환경 확인:
macos-harness doctor
- 텔레메트리 비활성화(선택):
macos-harness telemetry disable
- 하네스 실행 예시:
macos-harness <<'PY'
frame = mac.see("Spotify")
mac.key("cmd+k", app="Spotify")
mac.type("Alessia Cara", app="Spotify")
mac.click(640, 420, app="Spotify")
PY
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try browser-use/macos-harness
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
이걸로 써먹는 법
맛봤다면 이제 써먹을 차례 — 이 레포를 내 일과 사업에 응용하는 방법을 모아뒀어요.
🍳 레시피 — AI에게 이대로 시켜보세요
레시피 불러오는 중…
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「자동화·워크플로우」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/browser-use/macos-harness)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기