DEDUPED Hot AI repos, turned into use cases Get 5 a day

What you can do with 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.

Trended earlier

Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk.

Authorization notice. This tool is dual-use. Only use it on software, sites and systems you own or have explicit permission to test, and follow the relevant licenses and terms of service.

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.

    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.

    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.

    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

  1. 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.
  2. Open browser-use/macos-harness on GitHub and read the README and license.
  3. Install or upgrade macOS Harness from https://github.com/browser-use/macos-harness with uv using Python 3.12.
  4. Run macos-harness install --agent claude for Claude Code, or the matching agent name for your CLI. (inferred, check the README)
  5. Run macos-harness doctor and grant any missing macOS permission when asked.
  6. 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.

macOS Harness alternatives · Best AI repos for Software and DevOps

About this repo

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:

[![Featured on Deduped](https://dedupedai.com/badge/browser-use-macos-harness.svg)](https://dedupedai.com/use-cases/browser-use-macos-harness/?ref=badge)

More badge styles and HTML

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.