sk-ruban/notchi

What it solves

Notchi provides a visual, real-time feedback system for users of Claude Code and Codex. Instead of relying solely on the terminal, it uses the macOS notch to display animated mascots that reflect the current state of the AI agent (such as thinking, working, or waiting) and the emotional sentiment of the user's prompts.

How it works

The app installs shell script hooks into Claude Code and Codex. When these agents trigger events, the hooks send JSON payloads via a Unix socket to Notchi. A state machine then maps these events to specific sprite animations. Additionally, the app can connect to Anthropic or OpenAI APIs to perform sentiment analysis on prompts, which triggers emotional reactions in the mascots.

Who it’s for

macOS users with a notched MacBook who use Claude Code or Codex and want a visual way to track AI agent activity, session time, and API usage costs.

Highlights

• Real-time Activity Tracking: Visualizes events like tool use, compaction, and permission requests through animations.
• Sentiment Analysis: Uses LLM APIs to make mascots react emotionally (happy, sad, etc.) to user prompts.
• Usage Dashboard: Tracks daily costs and token usage over the last 30 days per provider.
• Multi-session Support: Displays separate mascots for concurrent sessions from different agent families.
• Customization: Supports custom sound effects and multiple system languages.