How to use NotchFit

NotchFit is sold on Whop for $20 once. There's no trial and no license key — your purchase is the download.

1. Buy NotchFit on Whop.
2. Open your purchase on Whop, go to Software and click Download.
3. Open the DMG and drag NotchFit to Applications.
4. Open NotchFit from Applications. It's signed and notarized, so macOS opens it without warnings.

NotchFit lives in the menu bar as a small figure icon — there's no Dock icon. It opens at login, and the first time it starts a short welcome walks you through connecting your AI and building your plan (replay it any time from the app's Guide tab).

1. Open the Setup tab and click Install / update integrations. That installs the Claude Code plugin (/notchfit:plan plus activity hooks) and the Codex skills and hooks ($notchfit-plan).
2. Restart any Claude Code sessions that were already running, so they load the plugin.
3. Codex only: run /hooks in Codex once and trust the NotchFit hooks.
4. Use the Try it buttons — Simulate: AI working, AI done, permission, and Test voice — to see the notch react.

The hooks run asynchronously in the background and talk to the app over localhost, so they never slow Claude or Codex down — even if NotchFit isn't running.

Run /notchfit:plan in Claude Code or $notchfit-plan in Codex. Your AI asks about your age, height, weight, fitness level, goal, equipment, days per week, minutes per day and injuries, then writes a weekly plan using only exercises the notch can animate.

The plan is saved to ~/.notchfit/plan.json, validated, and picked up by the app instantly — no restart.

When Claude Code or Codex starts a task, the notch opens. On the left is a Start workout card; on the right, the Claude updates feed: what your AI is working on, when it's done, and when it needs permission.

• Ignore it and the notch just shows done and needs-permission alerts. It minimizes 30 s after your AI finishes.
• Tap Start workout to get your first exercise with a countdown ring, plus Done, Skip and Pause.
• After each set: a burst of confetti, then a rest timer, then Start set. Every set starts only when you tap it — the workout never runs ahead of you.
• Alerts that arrive mid-set wait until the set ends. Permission alerts stay until you answer them.
• Open terminal jumps straight to that session's Terminal or iTerm2 tab.

Once today's workout is done, NotchFit goes quiet: the notch only shows your AI's alerts until tomorrow.

Hide workout / Show workout

Pauses the workout and turns the notch into an AI-progress-only panel. Tap again to bring the workout back.

Speaker

Mutes the voice and chimes.

⌃ (chevron)

Minimizes the notch until the next AI task.

Hover

Hover over the notch to peek at it while it's minimized.

Click the figure icon in the menu bar for quick controls — set progress, AI status, Set done, Skip, Mute voice, Open notch while AI works — and to open the app window. The window has six tabs:

Today

Today's workout and where you are in it.

Plan

Your weekly plan, the /notchfit:plan command, and Quick plan.

Library

All 239 exercises, filterable by category, with the muscles each works.

History

Your streak and a calendar of the days you moved.

Setup

Install / update or uninstall integrations, and the Try it buttons.

Settings

Voice & chimes, announce each set, voice picker, show the workout in the notch, keep the notch open while your AI works, open at login.

Settings

Integrations also link a notchfit command, handy for scripts or a quick keyboard workflow. You never need it for normal use.

$ notchfit start

Start today's workout

$ notchfit stop

Stop today's workout

$ notchfit done

Finish the current set

$ notchfit skip

Skip the current set

$ notchfit now

Start the next set now

$ notchfit pause / resume

Pause or resume the workout

$ notchfit status

JSON status: current set and AI sessions

$ notchfit validate [file]

Check a plan.json (default ~/.notchfit/plan.json)

$ notchfit reload

Reload plan.json into the app

$ notchfit catalog

The exercise catalog (ids the notch can animate)

$ notchfit simulate done|working|permission

Test the notch without a real AI task

$ notchfit doctor

Check the install, integrations and the local server

To update, download the latest DMG from your Whop purchase and replace the app in Applications. Your plan and history are kept.

To uninstall, open Setup → Uninstall (this removes the Claude Code plugin, the Codex hooks and the CLI link), then delete NotchFit from Applications. Your data lives in ~/.notchfit — delete that folder too if you want a clean slate.