Skip to content

smughead/Loupe

Repository files navigation

Loupe

Target elements, not screenshots.

Loupe is a macOS accessibility inspector that generates AI-agent-ready output. I built this for myself to speed up Mac app development with Claude Code. Hopefully you find it useful too.

https://smughead.github.io/Loupe/

What it does

  • Inspect any UI element in any Mac app
  • Annotate what you want changed
  • Copy structured, agent-readable output
  • Paste into Claude Code, Cursor, Codex — and watch them build

How it works

Hover — Point at any element in any app and see accessibility info in real-time.

Annotate — Click an element, describe the change you want in plain English.

Copy — Hit the copy button to get structured output with element roles, hierarchy paths, and search patterns.

Build — Paste into your AI assistant. It knows exactly which element to target — no screenshots, no guessing.

Install

Download the latest release:

Download Loupe (.dmg)

Or build from source:

git clone https://github.com/smughead/Loupe.git
cd Loupe
open Loupe.xcworkspace

Build and run with Xcode (Cmd+R).

Requirements

  • macOS 14.0+ (Sonoma)
  • Accessibility permissions — Loupe will prompt on first launch

Inspired by

agentation.dev — same concept for the web. Loupe does it for macOS.

License

MIT — do what you want with it. See LICENSE.

About

macOS accessibility inspector for AI-agent workflows. Hover, annotate, copy structured output.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages