Notchi

A macOS notch companion that reacts to Claude Code and Codex activity in real-time.

[][dmg]

https://github.com/user-attachments/assets/e417bd40-cae8-47c0-998a-905166cf3513

What it does

• Reacts to Claude Code and Codex events in real-time (thinking, working, permission requests, compaction, errors, completions)
• Analyzes prompt sentiment via Anthropic or OpenAI APIs to show emotions (happy, elated, sad, neutral, sob)
• Click to expand and see session time and usage quota
• Tracks daily cost and token usage over the last 30 days, per provider or combined
• Supports multiple concurrent sessions, each with its own mascot from the Claude or Codex sprite family
• Sound effects for events with support for importable custom sounds (optional, auto-muted when terminal is focused)
• Available in English, 日本語, 简体中文 / 繁體中文, 한국어, and Tiếng Việt (follows your system language)
• Auto-updates via Sparkle

Requirements

• macOS 15.0+ (Sequoia)
• MacBook with notch
• Claude Code (opens in a new tab) and/or Codex (opens in a new tab) installed

Finish Codex setup

If Codex shows Needs Approval, open Settings → Agent Hooks → Codex.

Click Open in Terminal, enter /hooks, and approve the three Notchi hooks. Then start a new Codex chat and send a message.

How it works

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.