back to home

sk-ruban / notchi

notch app for coding tools

View on GitHub
496 stars
37 forks
15 issues

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing sk-ruban/notchi in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/sk-ruban/notchi)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

Notchi > [!IMPORTANT] > If you're currently on Notchi , please install or later manually from the DMG here. The in-app updater in is broken for that first upgrade, but should work thereafter. A macOS notch companion that reacts to Claude Code activity in real-time. https://github.com/user-attachments/assets/e417bd40-cae8-47c0-998a-905166cf3513 What it does • Reacts to Claude Code events in real-time (thinking, working, errors, completions) • Analyzes conversation sentiment to show emotions (happy, sad, neutral, sob) • Click to expand and see session time and usage quota • Supports multiple concurrent Claude Code sessions with individual sprites • Sound effects for events (optional, auto-muted when terminal is focused) • Auto-updates via Sparkle Requirements • macOS 15.0+ (Sequoia) • MacBook with notch • Claude Code installed Install • Download from the latest GitHub Release • Open the DMG and drag Notchi to Applications • Launch Notchi — it auto-installs Claude Code hooks on first launch • A macOS keychain popup will appear asking to access Claude Code's 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 API key. This enables sentiment analysis of your prompts so the mascot reacts emotionally • Start using Claude Code and watch Notchi react How it works Notchi registers shell script hooks with Claude Code on launch. When Claude Code emits events (tool use, thinking, prompts, 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 the Anthropic API to analyze user prompt sentiment for emotional reactions. Each Claude Code session gets its own sprite on the grass island. Clicking expands the notch panel to show a live activity feed, session info, and API usage stats. Contributing If you have any bugs, ideas, or would like to contribute through pull requests, please check out Contributing to Notchi. Credits • Claude Island — design inspiration for the app • Readout — design inspiration for notchi.app • Aseprite — sprite design License MIT