cookinn.notch

A minimal companion for Claude Code on macOS. Shows what Claude is doing. Nothing more, nothing less.

demo.MOV

Installation

Homebrew

brew tap ojowwalker77/cookinn-notch
brew install --cask cookinn-notch

Update

The app checks for updates automatically and notifies you in the menu bar. Click to update via Homebrew directly from the app.

Manual update:

brew update && brew upgrade cookinn-notch

Manual

Download the latest .dmg from Releases.

Usage

Sessions automatically appear in notch when started. No setup needed.

Re-pin a session (after removal)

/send-to-notch

Remove from notch

/remove-from-notch

What it shows

• Current tool (Read, Edit, Bash, etc.)
• Project name
• Context window usage
• Activity patterns
• Alert mode: Pulses red when Claude needs your permission/input, with optional sound alerts
• Team badge: Shows active teammate count when using agent teams
• Context compaction: Displays "Compacting" during context window compaction
• Ralph Loop Detection: Shows autonomous loop progress from Ralph Wiggum (OpenCode) and Ralph for Claude Code

Fun fact: The alert sound was designed and crafted by hand by the author (@ojowwalker77).

Documentation

• Hooks Configuration - How Claude Code hooks work
• Slash Commands - /send-to-notch and /remove-from-notch

Requirements

• macOS 15.0 (Sequoia) or later
• Claude Code CLI v2.1.x+

Credits

This project includes Ralph loop detection, made possible by:

• Ralph Wiggum by @th0rgal - The original Ralph loop implementation for OpenCode
• Ralph for Claude Code - Ralph loop adaptation for Claude Code CLI

Thank you to the creators for pioneering autonomous AI development loops!

License

MIT