Notchi : visualiser l’activite Claude Code en temps reel dans l’encoche macOS
https://github.com/sk-ruban/notchi
📌 Notchi transforme l’encoche des MacBook en tableau de bord vivant pour Claude Code, avec des reactions en direct pendant les phases de reflexion, d’execution d’outils, d’erreur et de completion. L’app cible un besoin concret: garder un signal visuel permanent sur l’etat des sessions sans monopoliser la fenetre du terminal.
Le principe est simple: une petite presence graphique reste dans l’encoche et reflète ce qui se passe dans les sessions actives. Quand une commande tourne, l’animation change; quand une tache se termine, l’etat bascule; quand une erreur survient, le retour visuel est immediat. Au lieu de verifier manuellement l’ecran toutes les minutes, l’information d’etat remonte en continu, dans une zone qui reste visible meme quand plusieurs fenetres se superposent.
Dans un usage quotidien, l’avantage principal est la reduction des allers-retours mentaux. Sur une longue session de dev, il devient facile de lancer une action, changer d’application, puis revenir au bon moment. Notchi apporte aussi un suivi multi-sessions: chaque session Claude Code peut etre representee separément, ce qui aide a ne pas confondre une tache locale rapide avec un traitement plus long en parallele. Pour les phases de test, de refacto ou de generation de code, ce suivi direct fluidifie le rythme de travail.
L’installation est orientee simplicite: telechargement du DMG depuis les releases, glisser-deposer dans Applications, puis premier lancement. L’app installe automatiquement les hooks necessaires pour capter les evenements Claude Code. Une autorisation Trousseau macOS est demandee pour acceder au token OAuth en cache, ce qui permet d’afficher les statistiques d’usage API. Ensuite, l’application devient essentiellement plug-and-play: on lance Claude Code, et l’encoche commence a reagir.
Le fonctionnement interne repose sur une chaine technique claire: les hooks shell recoivent les evenements du CLI, envoient des payloads JSON via socket Unix, puis un parseur les route vers une machine d’etats qui pilote les sprites animes. Cette architecture apporte deux points utiles: une latence faible sur les transitions visuelles, et une separation nette entre collecte d’evenements et rendu UI. Resultat, l’outil reste reactif meme quand la session produit beaucoup d’activite.
L’app propose aussi une couche “emotion” optionnelle via cle API Anthropic. Quand cette option est activee, le comportement visuel varie selon la tonalite des prompts, avec plusieurs etats emotionnels. Ce module n’est pas obligatoire pour l’usage principal, mais il enrichit le retour d’etat et rend l’interface plus lisible sur des sessions longues. Cote audio, des effets sonores peuvent etre actives, avec un mode d’auto-mute quand le terminal est au premier plan pour eviter le bruit inutile.
points cles
- ⚡ Retour visuel instantane de l’etat Claude Code (thinking, tool call, erreur, completion).
- 🧭 Suivi de plusieurs sessions en parallele sans jongler entre fenetres.
- 🔌 Installation rapide avec hooks auto-configures au premier lancement.
- 🔐 Integration macOS Keychain pour exploiter les stats d’usage API.
- 😊 Mode emotion optionnel via API key Anthropic pour enrichir le feedback.
- 🔄 Auto-update integre via Sparkle pour garder l’app a jour.
Notchi tourne en local sur macOS et n’impose pas d’infrastructure cloud dediee. Le coeur du flux reste sur la machine, avec des echanges internes via socket Unix. C’est un point important pour la confidentialite operationnelle: l’application ne remplace pas le terminal ni le moteur de generation, elle observe et met en forme des evenements d’execution. La partie analyse emotionnelle depend d’une API key si l’option est activee; sans cette option, l’usage conserve un perimetre plus sobre, limite au suivi d’activite.
Sur la compatibilite, le projet vise macOS 15+ (Sequoia) et un MacBook avec encoche. Cette contrainte materielle est structurante: l’experience est pensee pour ce format d’affichage. Pour les utilisateurs sur desktop sans notch ou sur un OS different, l’outil n’est pas le bon candidat. En revanche, pour un poste mobile MacBook avec usage intensif de Claude Code, la proposition est tres specialisee et directement exploitable.
Au niveau demarrage, la courbe est courte. Le chemin minimal tient en quelques etapes: installer, valider l’acces Keychain, lancer Claude Code, observer les etats en direct. La configuration avancee (emotion, sons, preferences) vient ensuite sans bloquer la mise en route. Cette progression est bien calibree pour un usage productif des le premier jour, puis une personnalisation graduelle selon les habitudes.
Concretement, Notchi apporte une couche de telemetrie visuelle legere mais tres utile dans les workflows IA en terminal. L’outil ne cherche pas a tout centraliser: il se concentre sur une fonction precise, rendre visible le bon signal au bon moment. Pour un usage quotidien de Claude Code sur MacBook, c’est une extension pragmatique qui limite les interruptions et ameliore le pilotage des sessions en continu.
