sk-ruban

Notchi — Development skill for Claude Code

Development community

notch app for claude code & codex.

How to install Notchi

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sk-ruban/notchi and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Notchi does

notch app for claude code & codex.

Alternatives in Development

  • Hapi — App for Claude Code / Codex / Gemini / OpenCode, vibe coding anytime, anywhere 3.6k ★
  • Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
  • Chops — 1,000+ macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp 1.1k ★

README

Notchi

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

[![Download for macOS](assets/download-macos.svg)][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

Install

  1. [Download the latest DMG][dmg] (all versions are on the [releases page](https://github.com/sk-ruban/notchi/releases))

  2. Open the DMG and drag Notchi to Applications

  3. Launch Notchi, it auto-installs Claude Code and Codex hooks on first launch (whichever are present)

  4. If a macOS keychain popup appears asking for access (used for API usage stats), click **Always Allow** so it won't prompt again

    Keychain access popup
  5. *(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

    Emotion analysis settings
  6. Start using Claude Code or Codex and watch Notchi react

  7. Track usage by clickin