Termy → Tutorial → The notch

The notch

The point of Termy: you can look away from the agent and still know what it's doing.

What the pill tells you

SpinnerThe agent is working. The line underneath says what it's doing right now — "Editing App.swift", "Running npm test".
Yellow warningIt needs you: a question, or permission to run something.
Green checkmarkThe turn finished. It fades after a few seconds.
NothingNothing is running anywhere on your Mac.

This comes from Claude Code's and Codex's own hook events, not from reading the screen, so it's exact. On a Mac without a notch, the menu bar icon changes color instead.

Silent mode (Pro)

Watching a movie while a long task runs? Turn on Silent mode with the moon in the menu bar card, in Settings, or with a shortcut you pick in Settings → Shortcuts. The agents keep working, but the notch stays plain, and there are no notifications, sounds or pop-ups. The menu bar icon turns into a moon so you remember. Turn it off and the notch shows where everything stands.

Approving commands

When your agent wants to use a tool, the notch drops open with the command and Allow / Deny. There's a 30-second countdown: ignore it and the agent asks in the terminal as usual, with all of its own options. More options… hands it back to the terminal immediately.

Notifications you can answer

On an external display, where the notch isn't in front of you, Termy sends a notification instead. It carries Allow, Deny, Open — and Reply, which gives you a text field. Type your answer, hit Send, and it goes straight into the session. If the agent is mid-turn, your reply is queued and sent when the turn finishes.

Jumping to whoever needs you

With several agents running, the hard part is finding the one that's waiting. Press ⌥⇧` and Termy brings up the next session that needs an answer. Press it again for the one after that. The same thing sits at the top of the Sessions tab when you right-click the menu bar icon: "api-server is waiting for you".

Dictating a prompt

Press ⌥V and talk. Your words appear under the notch as you speak, and when you stop — or press ⌥V again — they're sent to the active session. There's also a microphone button in the panel's top bar.

The first time, macOS asks for the microphone and speech recognition. Where the language supports it, recognition runs on your Mac.

With Pro you can switch to Whisper, OpenAI's speech model, in Settings → General → Dictation. It runs on your Mac after a one-time download, handles mixed languages and technical words, and is told your project's name and the files the agent edited, so "SessionStore.swift" comes out right. Pick the language there too, or let it detect it.

Both shortcuts are yours to change, in Settings → Shortcuts — or to switch off, if ⌥V collides with something you already use.