Notchly monitors terminal output to detect when a Claude Code session completes a task or is waiting for your approval. When it detects a state change, it fires a native macOS notification so you can step away from your computer and come back when the work is done. Notifications are only sent when the Notchly window is not in the foreground — if you’re watching the terminal, you won’t be interrupted.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/javierpr0/Notchly/llms.txt
Use this file to discover all available pages before exploring further.
Notification types
Task Completed — fires when Claude finishes a task and the terminal returns to idle. The notification title is Task Completed (or Task Failed if Notchly detected an error in the output), and the body begins with the session name followed by a summary extracted from the terminal output. Needs Input — fires when Claude is waiting for your response — a permission prompt, a yes/no question, or any other interactive pause. The notification title is Action Required and the body shows the session name.Notification actions
Each notification type carries different action buttons.- Task Completed
- Needs Input
View — tapping the notification or its View button brings Notchly forward and switches to the session that fired it. All other stacked notifications for that same session are cleared from Notification Center at the same time.
Noise filtering
Not every terminal event fires a notification. Two mechanisms keep the signal-to-noise ratio high:- Minimum task duration — tasks that complete in under 7 seconds of active working time do not fire a “task completed” notification. This filters out trivial single commands that don’t warrant an interruption. The threshold is measured against actual working time (from
.workingto.idle), not wall-clock time — the 3-second confirmation delay used to stabilize the idle transition is excluded from the measurement. - Per-tab mute — right-click any tab and toggle Mute Notifications to suppress all notifications for that tab. The setting persists across app restarts. A muted tab still shows status indicators in the tab bar and the notch pill; it just doesn’t send macOS notifications.
Notification permissions
On first launch, Notchly requests macOS notification permission viaUNUserNotificationCenter. Allow it when prompted — without permission, no notifications of any kind will be delivered.
Notchly registers two notification categories:
| Category identifier | Used for | Action buttons |
|---|---|---|
NOTCHY_SESSION | Task completed / task failed | View |
NOTCHY_SESSION_WAITING | Needs input | Continue, View |