Notate

Product Introduction

1. Definition: Notate is a native macOS menu bar utility application designed for advanced screen capture and annotation. It functions as a specialized tool for creating precise, context-rich visual feedback by freezing dynamic screen states that traditional screenshot tools miss.
2. Core Value Proposition: Notate exists to solve the communication gap in digital workflows where pointing is more effective than describing. Its primary value is enabling users to capture and annotate ephemeral UI states—like open dropdown menus, hover effects, and animation frames—and export this feedback in formats directly actionable by both human teammates and AI coding agents.

Main Features

1. Instant Screen Freeze: Notate captures the exact pixel state of your screen the moment it's invoked, using macOS's screen recording APIs. This technical approach freezes all transient visual elements, including open context menus, focus states, and tooltips, preventing any underlying application movement during the annotation process.
2. Frame-by-Frame Recording & Candle Timeline: Beyond static captures, Notate can record screen activity over time. It generates a visual "candle timeline" scrubber, allowing users to scroll through individual frames of a recording and place annotations on the precise frame where an issue occurs, such as a broken animation sequence.
3. Gesture-Based Annotation Engine: The interface eliminates traditional tool palettes. The system interprets user gestures: a click places a numbered pin, a drag creates an arrow, and closing a loop snaps to a perfect ellipse or rectangle. This modaless approach prioritizes speed and flow.
4. Agent-Ready Export System: Notate offers two export modalities. "Text & Image" copies markdown-formatted text with numbered comments and local image links to the clipboard, a format optimized for ingestion by AI agents like GitHub Copilot or Cursor. "Image" renders and copies a single composited image with all annotations burned in, suitable for human review.
5. Session Archiving (.notate files): Every capture session is saved as a versioned, portable .notate file. This archive contains all original images and vector-based annotation data, allowing users to reopen the session later to add new comments or modify existing ones without loss of fidelity.

Problems Solved

1. Pain Point: The inability to reliably capture and communicate feedback on dynamic, transient user interface elements and micro-interactions, leading to vague bug reports and inefficient design/development handoffs.
2. Target Audience: UI/UX designers reviewing prototypes and micro-interactions; front-end and software engineers debugging animations or conducting code reviews; product managers creating precise feature walkthroughs; QA testers documenting visual bugs; and developers working with AI agents that require structured, visual context.
3. Use Cases: Pinning a visual bug on a specific frame of a CSS animation; annotating a design flaw in an open dropdown menu; providing clear, numbered feedback on a GitHub pull request diff; creating a step-by-step product tutorial with annotated screenshots; supplying an AI coding agent with exact visual context for a requested code change.

Unique Advantages

1. Differentiation: Unlike universal screenshot tools (e.g., macOS Screenshot, CleanShot X) or design-specific annotation plugins (e.g., Figma comments), Notate is purpose-built for technical and design workflows requiring temporal precision and agent-compatible output. Its "honest dedupe" feature, which collapses identical frames but preserves their occurrence with gap markers, differentiates it from simple screen recorders.
2. Key Innovation: The integration of a frame-accurate screen recorder with a gesture-driven annotation layer and a structured markdown export pipeline. This creates a closed-loop system from visual problem identification to actionable, shareable feedback, bridging the gap between human observation and machine-readable instruction.

Frequently Asked Questions (FAQ)

1. Is Notate compatible with older versions of macOS? No, Notate requires macOS 15 (Sequoia) or later, as it leverages modern APIs and frameworks specific to this operating system version for its screen capture and performance.
2. How does Notate handle privacy and where is my data stored? Notate requires Screen Recording permission to capture your display content. All captured frames and annotation data are stored locally on your Mac in a user-designated folder; no data is transmitted to external servers, ensuring complete privacy.
3. Can I use Notate for creating video tutorials? While Notate can record screen activity, its primary function is frame-accurate annotation, not video editing or narration. It is best suited for creating annotated still frames from a recording rather than producing polished video content.
4. What does "agent-ready export" mean in practice? It means the exported markdown includes locally hosted image paths and structured comments. An AI agent (like one integrated into your IDE) can parse this markdown, understand the visual context from the image, and execute code changes based on the numbered feedback points.
5. Is Notate really free and what is the license? Yes, Notate is completely free, open-source software distributed under the permissive MIT License. The source code is publicly available on GitHub, and the application is distributed via a DMG file from its GitHub Releases page.