gitwtfhub

wtf is appshots?

eyhn/appshots — explained in plain English

Analysis updated 2026-05-18

16SwiftAudience · developerComplexity · 1/5Setup · easy

TL;DR

A macOS menu bar app that captures a screenshot and the text accessibility description of any window, then copies both to your clipboard so you can paste them into an AI coding assistant like Claude Code.

Mindmap

mindmap
  root((appshots))
    What it does
      Captures screenshot
      Reads accessibility tree
      Copies to clipboard
    How to trigger
      Both Option keys
      Menu bar icon
    Output format
      app-shots tag
      Screenshot plus text
    Use with
      Claude Code
      Other AI agents
    Tech
      Swift
      macOS native

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Press both Option keys to snapshot your app's current screen and paste the result into Claude Code so it can see what you're debugging.

REASON 2

Share the accessibility tree of a UI bug with an AI assistant so it understands the interface structure without needing full source code.

What's in the stack?

SwiftmacOS

How it stacks up

eyhn/appshotsaahonarmand/neticucounter-ltd/clonk
Stars161616
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyhard
Complexity1/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Wtf does this do

Appshots is a small macOS app that sits in the menu bar and helps AI coding assistants understand what is happening on your screen. When you trigger it (by pressing left Option and right Option at the same time, or by clicking its menu bar icon), it captures a screenshot of whatever app window is in front. It also reads the accessibility state of that window, which is structured text describing the interface elements the app is showing, similar to what a screen reader would describe to a visually impaired user. The tool bundles the screenshot and the accessibility description into a reference block and places it in your clipboard, formatted as an app-shots tag. You paste this into your conversation with an AI coding agent such as Claude Code, and the agent can use both the visual screenshot and the text description to understand what you are looking at. The project was inspired by a similar feature in OpenAI's Codex product, and it exists to bring that kind of dual context to Claude Code and other AI agents running on macOS. Without something like this, an AI agent responding to a question about your app's interface has no way to see what you are actually seeing. The app is written in Swift and is a native macOS application. The README is brief and does not cover installation steps in detail.

Yoink these prompts

Prompt 1
I've pasted an app-shots block from Appshots into this conversation. Based on the screenshot and accessibility description, what might be causing the misaligned button I see?
Prompt 2
Here is the app-shots output from a macOS settings panel. Help me write Swift code that matches this exact layout.
Prompt 3
I'm building a macOS tool similar to Appshots. Write the Swift code to capture the accessibility tree of the frontmost window as a string.

Frequently asked questions

wtf is appshots?

A macOS menu bar app that captures a screenshot and the text accessibility description of any window, then copies both to your clipboard so you can paste them into an AI coding assistant like Claude Code.

What language is appshots written in?

Mainly Swift. The stack also includes Swift, macOS.

How hard is appshots to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is appshots for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.