browser-use/macos-harness

LLMがMacでほぼあらゆるタスクを自由に実行できる、最もシンプルで薄いハーネス

インストール型ツール自由に使える · MIT自動化・ワークフローPython難易度
751+0今週0
51フォーク2Issue

中辛 の解説

PythonベースのmacOS操作ハーネスで、seekeytypeclickaxscriptの6つのプリミティブを使ってLLMエージェントがMacを自由に操作できます。CGWindow・CGEvent・Apple Accessibility・Apple Events・CDPを直接利用し、アプリを前面に出さずバックグラウンドでウィンドウを取得・操作できます。uvでインストールしてエージェントに1行のプロンプトを渡すだけで動作を開始でき、macos-harness doctorでパーミッション状況を確認できます。実際のChromeブラウザ(ログイン済みセッション)にもCDP経由でアクセス可能です。

이런 레포예요

이럴 때 쓰면 좋아요

  • アプリ専用ツールを用意せずにAIエージェントにMacのあらゆるアプリを操作させたいとき
  • バックグラウンドのアプリウィンドウを前面に出さずにスクリーンショット取得・操作を行いたいとき
  • ブラウザのログイン済みセッションを含むMac全体のタスクをLLMに自律実行させたいとき

핵심 기능

6つのプリミティブ(see/key/type/click/ax/script)でMac全体を操作アプリをフォアグラウンドに出さずバックグラウンドでウィンドウ取得・入力送信CDP経由で実際のChromeブラウザ(ログイン済み)にアクセス

대안 대비 차별점

アプリ固有ツールやフレームワーク不要で、ネイティブアプリ・ブラウザ・ファイルシステムを単一Pythonプロセスで横断操作できる点がComputer Use APIやPlaywrightと異なります。

食べた人たち

実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。

試食評 · 使った人のひとこと

まだ試食評がありません。使ってみたら、最初のひとことをどうぞ。

ほかのリポジトリの試食評を見る →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

준비물

  • macOS
  • Python 3.12
  • uv
  • Chrome(ログイン済みセッション用)
  • macOS アクセシビリティ・スクリーン収録などの権限

すぐ動かしてみる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가 안내하는 자세한 단계 보기
  1. エージェント(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.
  1. パーミッション確認コマンドを実行します
macos-harness doctor
  1. テレメトリを無効にしたい場合は以下を実行します
macos-harness telemetry disable
  1. ハーネスを直接呼び出してMac操作を試します
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")
print(browser.page_info())
PY

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try browser-use/macos-harness

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

これを仕事に活かす

味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。

レシピ — AI にこのまま頼んでみてください

レシピを読み込んでいます…

スター推移 · 7日

751+0 / 7일

使いやすさ · まねしやすいか

まねしやすいサンプル評点 52/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「자동화·워크플로우」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/browser-use/macos-harness.svg)](https://www.gitbap.com/r/browser-use/macos-harness)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る