ahkohd/Notate.app

Notate is a focused macOS annotation tool built around a problem that standard screenshot apps handle poorly. It can freeze temporary interface states such as open menus, hover effects, and focused controls, or record a sequence so users can comment on a specific animation frame. The gesture-based workflow is a strong design choice. Clicks create numbered comments, drags become arrows, and rough shapes automatically clean themselves up. This keeps the interface simple without limiting the types of feedback users can provide. Structured Markdown exports, coordinates, smart window cropping, session archives, and history make the output useful for designers, developers, and coding agents. The native Swift, AppKit, and SwiftUI codebase is clearly organized, while the automated release process covers signing, notarization, Sparkle updates, Homebrew distribution, and published artifacts. The README is also concise, visual, and unusually good at explaining why the product exists.

The biggest improvement area is privacy documentation. Notate receives Screen Recording permission, can capture an entire desktop, and preserves sessions in a history library. Users should be told exactly where captures are stored, how long they remain, whether deleted sessions can be recovered, what network requests the app makes, and whether any telemetry exists. A dedicated security policy and private reporting process would also help. Testing is another gap. The repository includes unit tests, but the README confirms there is no automated UI test suite. Capture permissions, multi-display behavior, cropping, export accuracy, and archive recovery are important enough to deserve repeatable integration tests. Contributor guidance could also include architecture notes and exact test commands instead of relying mostly on manual smoke testing. Overall, Notate is a polished, original tool with a clear audience and thoughtful interaction design. Better privacy guidance and broader automated testing would make this promising early project easier to trust and contribute to.