by sk-ruban
notch app for coding tools
# Add to your Claude Code skills
git clone https://github.com/sk-ruban/notchi[!IMPORTANT] If you're currently on Notchi
1.0.0, please install1.0.1or later manually from the DMG here. The in-app updater in1.0.0is broken for that first upgrade, but should work thereafter.
A macOS notch companion that reacts to Claude Code activity in real-time.
https://github.com/user-attachments/assets/e417bd40-cae8-47c0-998a-905166cf3513
Download Notchi-x.x.x.dmg from the latest GitHub Release
Open the DMG and drag Notchi to Applications
Launch Notchi — it auto-installs Claude Code hooks on first launch
A macOS keychain popup will appear asking to access Claude Code's cached OAuth token (used for API usage stats). Click Always Allow so it won't prompt again on future launches
(Optional) Click the notch to expand → open Settings → paste your Anthropic API key. This enables sentiment analysis of your prompts so the mascot reacts emotionally
No comments yet. Be the first to share your thoughts!
Start using Claude Code and watch Notchi react
Claude Code --> Hooks (shell scripts) --> Unix Socket --> Event Parser --> State Machine --> Animated Sprites
Notchi registers shell script hooks with Claude Code on launch. When Claude Code emits events (tool use, thinking, prompts, session start/end), the hook script sends JSON payloads to a Unix socket. The app parses these events, runs them through a state machine that maps to sprite animations (idle, working, sleeping, compacting, waiting), and uses the Anthropic API to analyze user prompt sentiment for emotional reactions.
Each Claude Code session gets its own sprite on the grass island. Clicking expands the notch panel to show a live activity feed, session info, and API usage stats.
If you have any bugs, ideas, or would like to contribute through pull requests, please check out Contributing to Notchi.
GPL-3.0-only. See LICENSE.