What do you want to do?
3 use cases
-
Let a coding agent operate a running Mac app
Give an agent read and click access to a Mac app window, one shell command per step.
- macOS Harness
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using the macos-harness repo at https://github.com/browser-use/macos-harness, run `macos-harness get_app_state --app <app name>` on the target app and list the numbered elements in its window. Verify that the output contains at least one numbered element and a screenshot path before you click anything.
-
Fill fields in a desktop app that has no API
Set field values and type text into a Mac app window using numbered elements from a read.
- macOS Harness
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using the macos-harness repo at https://github.com/browser-use/macos-harness, read the window of <app name> with `macos-harness get_app_state --app <app name>` and set each field listed in <values file> with `macos-harness set_value`. Verify by reading the window again and reporting every field that does not match its expected value.
-
Check what an app window shows after each step
Read a window, act once, then read again to see only what changed.
- macOS Harness
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using the macos-harness repo at https://github.com/browser-use/macos-harness, read <app name> with `macos-harness get_app_state`, perform the action in <test steps>, and read the window again. Verify and report only the lines that changed between the two reads, and state whether the expected change appeared.
How to use macOS Harness
- Check you have what it needs: A Mac running macOS, since the project is macOS only; Python 3.12 and uv, to install macOS Harness; Accessibility and Screen Recording permissions, which every call needs.
- Open browser-use/macos-harness on GitHub and read the README and license.
- Install or upgrade macOS Harness from https://github.com/browser-use/macos-harness with uv using Python 3.12.
- Run
macos-harness install --agent claudefor Claude Code, or the matching agent name for your CLI. (inferred, check the README) - Run
macos-harness doctorand grant any missing macOS permission when asked. - Run
macos-harness get_app_state --app "TextEdit"to read the window as numbered text.
These steps come from our top use case, Let a coding agent operate a running Mac app, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freemacOS Harness alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers and operators who use a coding agent such as Claude Code or Codex and need it to work inside a Mac app that has no API.
- Why it is hot
- LanguagePython
- Sourcegithub.com/browser-use/macos-harness · Back to Hot repos
Requirements
- A Mac running macOS, since the project is macOS only
- Python 3.12 and uv, to install macOS Harness
- Accessibility and Screen Recording permissions, which every call needs
- A coding agent CLI such as Claude Code or Codex to run the commands
Maintain macOS Harness? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/browser-use-macos-harness/?ref=badge)
Questions about macOS Harness
What is macOS Harness?
A thin set of shell commands that lets an LLM agent read and control apps running on a Mac, one command per step, in the background. It is an open-source project on GitHub: https://github.com/browser-use/macos-harness.
Who is macOS Harness for?
Developers and operators who use a coding agent such as Claude Code or Codex and need it to work inside a Mac app that has no API.
What can I do with macOS Harness?
3 use cases so far, for example: Let a coding agent operate a running Mac app; Fill fields in a desktop app that has no API; Check what an app window shows after each step. Each has steps and a copy-paste agent prompt.
What do I need to run macOS Harness?
A Mac running macOS, since the project is macOS only; Python 3.12 and uv, to install macOS Harness; Accessibility and Screen Recording permissions, which every call needs; A coding agent CLI such as Claude Code or Codex to run the commands.
What are alternatives to macOS Harness?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is macOS Harness safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.