Open Source

AI Annotation

Point. Write precise feedback. AI understands exactly what you mean.

A SwiftUI debug overlay for macOS that lets you visually select any UI component and generate AI-friendly markdown. Your AI assistant will know exactly which element you're talking about.

View on GitHubHow It Works
Available for:
macOS
iOSsoon
visionOSsoon
Works with:
Claude Code
Cursor
GitHub Copilot
MyApp.app — Annotation Mode
Sign In
email@example.com
••••••••
Sign In
Element Selected
Button [signInButton]
⏎ Copy to clipboardESC Cancel

The Problem

AI coding assistants struggle to identify exactly which UI element you're talking about.

Text Descriptions Are Ambiguous

'The blue button at the bottom' could match multiple elements. Your AI assistant has to guess which one you mean.

"Can you change the login button?" → Which button? There are 3...

Screenshots Lack Context

Images show what the UI looks like, but not the technical details your AI needs — identifiers, hierarchy, frames.

[Screenshot attached] → I can see the button, but what's its identifier?

How It Works

A Swift Package you can integrate into any SwiftUI app. One line of code, instant clarity.

1

Activate

Tap the floating annotation button to enter debug mode

2

Select

Hover and click any UI element to select it

3

Annotate

Add your feedback or change request

4

Paste

Structured markdown is copied — paste into your AI

AI-Friendly Output

Structured markdown that gives your AI assistant everything it needs.

Markdown Output
## UI Annotation

**Element:** Button [signInButton]

**Hierarchy:** TabView > ScrollView > VStack > Button

**Frame:** (16, 420, 343, 50)

### Feedback

Change the button color to match the brand guidelines.

Built for Developer Workflows

Every feature designed to make AI-assisted development faster.

Visual Selection

Hover highlight and click-to-select. No guessing which element you mean.

Smart Detection

Automatically prioritizes accessibility identifiers for precise targeting.

Hierarchy Path

Full view hierarchy from root to element. Your AI knows exactly where it is.

Annotation History

Collect multiple annotations before copying. Review all at once.

Frame Coordinates

Exact position and size. Useful for layout debugging.

Keyboard Shortcuts

Enter to copy, ESC to close. Built for speed.

Quick Setup

Add AI Annotation to your project in under a minute.

1

Add Package Dependency

Swift Package Manager
Xcode GUI
// Package.swift
dependencies: [
.package(
url: "https://github.com/dobomatyas-blip/ai-annotation-app.git",
branch: "main"
)
]
// Add to your target dependencies:
.product(name: "AIAnnotation", package: "ai-annotation-app")
Xcode alternative: File → Add Package Dependencies → paste the GitHub URL → select Branch: main
2

Add to Your Root View

import SwiftUI
import AIAnnotation
struct ContentView: View {
var body: some View {
YourMainView()
.withAnnotationButton() // That's it!
}
}
3

Start Annotating

Click the floating button

Select any UI element

Paste markdown to AI

Technical Details

A lightweight Swift Package with no dependencies.

Requirements

  • Platform — macOS 13.0+ / iOS 16.0+
  • Swift — 5.9+
  • Framework — SwiftUI only
  • Dependencies — None

Open Source

  • License — MIT (with attribution)
  • Contributions — PRs welcome
  • Issues — GitHub Issues
  • Discussions — GitHub Discussions

Inspired by Agentation.dev

This tool brings the same concept to native SwiftUI apps. Agentation pioneered visual UI annotation for web applications — now you can have the same power in your iOS and macOS development workflow.

Visit Agentation.dev

Start Building Better with AI

Open source, easy to integrate, and designed for the way developers actually work.

Get StartedQuestions? Contact Us

Transform how you capture ideas

Voice is 3x faster than typing. Ear turns your spoken thoughts into organized notes, tasks, and insights — automatically. Be the first to try it.