# Add to your Claude Code skills
git clone https://github.com/sk-ruban/notchiLast scanned: 5/5/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-05T06:18:35.262Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
30 days in the Featured rail · terms & refunds
A macOS notch companion that reacts to Claude Code and Codex 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 and Codex hooks on first launch (whichever are present)
If you use Claude Code, a macOS keychain popup will appear asking to access its 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 or OpenAI API key. This enables sentiment analysis of your prompts so the mascot reacts emotionally
Start using Claude Code or Codex and watch Notchi react
Claude Code / Codex --> Hooks (shell scripts) --> Unix Socket --> Event Parser --> State Machine --> Animated Sprites
Notchi registers shell script hooks with Claude Code and Codex on launch. When either agent emits events (tool use, thinking, prompts, permission requests, compaction, 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 Anthropic or OpenAI to analyze user prompt sentiment for emotional reactions.
Each session gets its own sprite on the grass island, drawn from the Claude or Codex sprite family depending on which agent it came from. Clicking expands the notch panel to show a live activity feed, session info, and Claude/Codex 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.