Repolode
Submit
sk-ruban

sk-ruban/notchi

A macOS notch-area companion app that shows real-time reactions to Claude Code and Codex agent activity.

View on GitHubWebsite
Stars
1,042
Forks
78
Open issues
16
Last commit
16 days ago

What is it?

Notchi is a macOS app that sits in the notch and shows an animated mascot reacting to what Claude Code and Codex are doing. It registers shell script hooks with both agents on launch, receives events such as thinking, tool use, permission requests, compaction, errors and completions over a Unix socket, and maps them to sprite animations. Each concurrent session gets its own mascot from the Claude or Codex sprite family.

Clicking the notch expands a panel with a live activity feed, session time, and usage quota. A 30-day view tracks daily cost and token usage per provider or combined. With an Anthropic or OpenAI API key added in settings, the app analyzes the sentiment of your prompts so the mascot reacts emotionally. Sound effects for events are optional and can be replaced with custom sounds; they mute automatically when the terminal is focused.

The app requires macOS 15 or later and a MacBook with a notch, and it auto-updates via Sparkle.

Key features

  • 01Reacts to Claude Code and Codex events such as thinking, working, permission requests and errors.
  • 02Runs a separate mascot for each concurrent session.
  • 03Analyzes prompt sentiment with Anthropic or OpenAI APIs to drive emotional reactions.
  • 04Shows session time, usage quota, and 30-day cost and token charts.
  • 05Supports optional sound effects and custom sound imports.
  • 06Available in several languages and follows the system language.

Use cases

  • Keeping an eye on long-running Claude Code or Codex sessions without switching windows.
  • Noticing permission requests or errors from coding agents at a glance.
  • Tracking daily AI coding cost and token usage across providers.

Quick start

  1. 1

    Download the latest DMG from the releases page

  2. 2

    Open the DMG and drag Notchi to Applications

  3. 3

    Launch Notchi; it auto-installs the Claude Code and Codex hooks

Things to know

  • macOS 15.0+ only, and it requires a MacBook with a notch.
  • Requires Claude Code and/or Codex to be installed.
  • Sentiment analysis needs your own Anthropic or OpenAI API key (optional).

Topics

#claude-code#codex#macos#swift#ai-agent#developer-tools#menu-bar-app

FAQ

What is notchi?
A macOS notch-area companion app that shows real-time reactions to Claude Code and Codex agent activity. Notchi is a macOS app that sits in the notch and shows an animated mascot reacting to what Claude Code and Codex are doing. It registers shell script hooks with both agents on launch, receives events such as thinking, tool use, permission requests, compaction, errors and completions over a Unix socket, and maps them to sprite animations. Each concurrent session gets its own mascot from the Claude or Codex sprite family.
Is notchi free to use? What license does it have?
notchi is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is notchi still maintained?
Actively maintained. The last commit to notchi was on Oct 4, 2026.
What can I use notchi for?
Keeping an eye on long-running Claude Code or Codex sessions without switching windows. Noticing permission requests or errors from coding agents at a glance. Tracking daily AI coding cost and token usage across providers.
How do I install notchi?
Download the latest DMG from the releases page Open the DMG and drag Notchi to Applications Launch Notchi; it auto-installs the Claude Code and Codex hooks
Where can I get notchi?
The source code and installation instructions are on GitHub: https://github.com/sk-ruban/notchi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects