The AI that nudges you into flow.
About Ā· Download Ā· Demo Ā· FAQ
Nudge is an app for macOS that watches your screen and helps you stay in flow. Describe an activity and a duration ("I want to vibe code for an hour") and Nudge will notify you when it looks like you're doing something else.
See the releases page to find the latest DMGs.
demo.mp4
How does Nudge work?
During a focus session, Nudge takes screenshots every minute and asks a multimodal AI (e.g., GPT-4o-mini) whether you're doing the activity you chose for that session. When it detects you're distracted, Nudge sends you a notification.
You can read the detection code at /main/src/ai/openai/assess-capture/index.ts.
What is Nudge Cloud?
By default, Nudge sends screenshots directly to OpenAI using your API key. If you don't have an OpenAI key, you can use "Nudge Cloud," which proxies requests through **nudge.fyi**.
Screenshots may contain sensitive data, but I don't retain or observe them. I only host this server to make Nudge accessible to non-technical users.
You can contact me at felipe AT portalform.com with any questions or concerns.
What data does Nudge collect?
With Nudge Cloud: Nudge Cloud acts as a proxy server and doesn't collect any screenshot or session activity data. We save request headers to prevent abuse, as the server is currently free up to 20 session-hours a month. (I'm eating the cost for the sake of this experiment.)
Without Nudge Cloud: Data is exchanged directly with OpenAI. The data sent to GPT-4o may be accessible by the owner of the API key you enter.
Error tracking: We use Sentry for crashes and telemetry, but we don't collect PII as far as I know. I will consider making this optional in future versions.
Can I use other AI backends?
Not yet, but I'll add support if there's demand. Start a discussion to request specific providers.
How much does Nudge cost in AI usage?
Costs depend on the model you use, your screen size, and capture frequency.
During testing on July 2nd, 2025: a 1470x956 Mac screenshot used ~14k input tokens in GPT-4o-mini. At default settings (1-minute capture frequency), this works out to $0.002 per minute that Nudge is active, or about $0.12 per hour.
I'm looking for ways to reduce these costs. If you have ideas, start a discussion.
GPL-3.0