macOS accessibility inspector for AI-agent workflows. Hover, annotate, copy structured output. https://smughead.github.io/Loupe/
Find a file
smughead 5ce2e1cd97 Fix demo video crash on macOS 26 by bypassing _AVKit_SwiftUI bridge
Replace SwiftUI VideoPlayer with a direct NSViewRepresentable wrapper
around AVPlayerView to avoid a getSuperclassMetadata fatal error in
Apple's _AVKit_SwiftUI framework on macOS Tahoe.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 09:15:22 -04:00
Config Bump version to 1.1.0 for release 2026-02-04 09:03:56 -04:00
docs Move accent highlight from "screenshots" to "elements" in hero heading 2026-02-04 06:44:46 -04:00
Loupe Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
Loupe.xcodeproj Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
Loupe.xcworkspace Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
LoupePackage Fix demo video crash on macOS 26 by bypassing _AVKit_SwiftUI bridge 2026-02-04 09:15:22 -04:00
LoupeUITests Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
scripts Add Swift script to generate pixel-perfect DMG background images 2026-02-04 00:27:34 -04:00
.gitignore Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
CLAUDE.md Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
LICENSE Initial open-source release of Loupe v1.0.0 2026-02-03 23:37:54 -04:00
README.md Update README.md 2026-02-03 23:40:17 -04:00

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.