StudyNotch

Using it

Everything is a click. There are no shortcuts to remember.

Courses and sessions

Point at the notch and the island slides out a little on both sides, with the mascot in the left ear. Click it and the island opens. The highlighter icon in the menu bar has the same list of courses. Click anywhere else, or keep the pointer away for 15 seconds, and it goes back into the notch. For the last 10 seconds before it closes, a short line under the island shrinks.

The open island’s Home tab. On the left, a card with the mascot, MATH 237, its files, an Edit button, 50:00, a Start button and 25, 50 and 90 minute choices. On the right, three course pills and an add-course pill.

During a session, the notch keeps the mascot in its left ear and a progress ring with the minutes left in its right. Point at it and a one-line summary appears under the island: the course, your focus time and how many questions you asked. Click it and this opens:

The Home tab during a session. A green-tinted card with MATH 237, 17 minutes focused, 32:10 left, and buttons for Ask, capture, a 5-minute break and End. The MATH 237 pill on the right shows the time left.

The mascot

The island is home to StudyNotch’s mascot, a small round body of glossy black with two white eyes that change shape with what is going on and follow your pointer. When the island folds, it springs into the left ear; when the island opens, it springs to the left of the card, with a faint light behind it in the colour of the current state. It smiles when you point at it, and when you click it, it hops and says a few words. It is drawn in 3D the same way in the app and on this website.

Focused: eyes half closed. Drifting: wide eyes looking away. On a break: eyes closed, asleep. Writing an answer: eyes looking up to the right. Pointed at: smiling eyes. Session done: smiling eyes.
Focused, drifting, on a break, writing an answer, glad, session done.

Displays without a notch

On a screen without a notch, a small 80×24 black bar sits in the middle of the menu bar in place of the notch, with the mascot in its centre. It never draws a big black shape pretending to be a notch. Choose which screen the island lives on from “Notch island position” in the menu bar icon. The default is the screen with a notch.

Asking a question

Select text and right-click

In any app, select some text and right-click: a black button appears at the top of the menu. It says “Ask” during a session and “Ask StudyNotch” outside one. Click it and the question window opens right there.

It sits above the menu, not inside it. macOS doesn’t let an app add items to another app’s right-click menu, except inside the Services submenu at the bottom. So the button is attached directly above the menu the moment it opens, and it disappears when the menu closes.

Screenshots during a session

Formulas and graphs fall apart when you select them as text. Take a regular Mac screenshot during a session and the question window opens with that picture. Outside a session, nothing happens.

From the notch

“Ask” in the open island opens the question window with whatever text is selected. The camera button next to it (capture and ask) lets you drag out an area with crosshairs.

The question window: the selected sentence, four preset buttons, a text field and a Send button.
  1. Pick a button: “I don’t get this”, “Simpler”, “Example” or “One-line summary”.
  2. If you want to add something, type it in the field. You can also skip the buttons and just type a question.
  3. Press “Send”.

The answer streams into the same window. No Claude window appears.

The question window with an answer, its source page and a note that AI can be wrong: a button to save it as a review card, buttons to say where you are stuck, and a field for a follow-up question.
In Preview. Preview may not hand selected text to other apps. In that case, after you press the button, the app copies once and puts your clipboard back right away. Nothing is read before you press the button.

Drift cards

Stay more than 60 seconds on a site or app from your distraction list and a card appears.

It never shows a card while you are typing; it waits until your hands stop. If you don’t react for 8 seconds, or click elsewhere, it folds, and it won’t show for the same place again for 10 minutes. If you don’t touch your Mac for 3 minutes, it treats you as away and stops counting time.

The settings file

Choose “Open settings file” from the menu to open ~/StudyNotch/config.json. After editing it, choose “Reload settings”.

KeyMeaning
presetsThe list of courses: each course’s name, and the places allowed only in that course.
sessionMinutesSession length. The value you pick in the notch is saved here.
allowAlwaysPlaces that are always allowed. An entry with a dot is a site; one without is an app name.
distractionsPlaces that count as distractions.
nudgeAfterSecondsSeconds before a drift card appears. Default 60.
breakMinutesBreak length. Default 5.
offerOutsideSessionWhether a screenshot opens the question window outside a session too. Off by default.
soundsWhether the island plays quiet macOS system sounds. On by default.
displayWhich screen the island lives on. notch (default) is the screen with a notch, or the one with the menu bar if none has a notch. main is the screen with the menu bar; mouse is the screen with the pointer.
ai.providerauto, claude-cli, codex-cli or api-key.