A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.
Swift ai-agentsanthropicantigravityclaudeclaude-codecodexcursordynamic-islandgemini-cliiosiphonlinuxmacosmacos-appmenubar-appnotchopen-sourceswiftswiftuiwindows
Spec: Mochi and the Mac, Focus, screen capture
Claude5ad0083ea9e8
diff --git a/docs/SPEC.md b/docs/SPEC.mdindex 09148a94..d65c424f 100644--- a/docs/SPEC.md+++ b/docs/SPEC.md@@ -382,10 +382,12 @@ Ces raccourcis fonctionnent en arrière-plan sans permission Accessibilité.| Couper le son (`toggleMute`) | ⌃⌥M | `shortcut.toggleMute.keyCode` / `.flags` | Oui || Mochi sur le bureau (`toggleDesktopMochi`) | ⌃⌥D | `shortcut.toggleDesktopMochi.keyCode` / `.flags` | Oui || Ouvrir la garde-robe (`openWardrobe`) | ⌃⌥G | `shortcut.openWardrobe.keyCode` / `.flags` | Oui |+| Session Focus (`focusToggle`) | ⌃⌥F | `shortcut.focusToggle.keyCode` / `.flags` | Oui |+| Capture d'écran pour Claude (`captureScreen`) | ⌃⌥X | `shortcut.captureScreen.keyCode` / `.flags` | Oui (hors App Store) |- Si Carbon ne peut pas enregistrer un raccourci (conflit système), l'action est marquée `.conflict` dans `HotKeyCenter` et un indicateur apparaît dans Réglages → Raccourcis.- `toggleIsland` conserve les clés UserDefaults historiques (`hotkeyCode`, `hotkeyFlags`, `hotkeyEnabled`) pour ne pas casser les préférences existantes.-- Les actions marquées `isNonAppStore` (`attachFrontWindow`) sont omises du build App Store.+- Les actions marquées `isNonAppStore` (`attachFrontWindow`, `talkToCoucou`, `captureScreen`) sont omises du build App Store.### 14.2 Raccourcis locaux (actifs quand l'île a le focus)@@ -415,3 +417,34 @@ Réglages → Raccourcis (`ShortcutsSettingsView`) :- Les conflits système (Carbon a refusé l'enregistrement) sont signalés en orange.- Bouton **Tout réinitialiser** remet les valeurs par défaut sur toutes les actions.- Les raccourcis locaux sont affichés en lecture seule.++## 15. Mochi et le Mac++`MachineVitals` lit l'état du Mac toutes les 3 s, **seulement quand Mochi est à l'écran** (île visible ou Mochi sur le bureau). Île cachée : aucune lecture. Réglages → Général → « Mochi et ton Mac » (activé par défaut).++| Ce que lit Coucou | Seuil | Mochi |+|---|---|---|+| Processeur (`host_statistics`, tous les cœurs) | ≥ 80 % deux lectures de suite | transpire (gouttes), souffle vite |+| État thermique (`ProcessInfo.thermalState`) | fair / serious / critical | rougit, vagues de chaleur au-dessus de la tête dès serious |+| Pression mémoire (`DispatchSource.makeMemoryPressureSource`) | warning / critical | gonfle |+| Batterie (`IOPSCopyPowerSourcesInfo`), sur batterie | < 20 % / < 10 % | paupières lourdes et bâillements / s'endort (z) |++- Les humeurs ne s'affichent que dans les états calmes (idle, working, thinking, searching, finished) ; fatigue et sommeil seulement en idle et finished. Une demande de permission les efface.+- Brancher le chargeur pendant que Mochi est fatigué : il se réveille (émote happy, son `pop`).+- Pointeur sur Mochi (ou sur l'île compacte) : une ligne sous l'île dit pourquoi, par ex. « CPU 94 % · node, Google Chrome » (les deux apps qui prennent le plus de processeur, lues seulement quand il transpire).+- Dessin : `MochiMood.swift` (CoucouKit), l'iPhone ne règle jamais l'humeur.++## 16. Focus++- Démarrer : le minuteur de l'en-tête de l'île, ⌃⌥F, Réglages → Focus, ou « OK Coucou, focus 25 minutes » (outil `focus` de Claude).+- Pendant la session : Mochi met un casque, l'île compacte affiche le temps restant à la place des pastilles et ne se cache plus, `SoundEngine` ne joue que `approval`, `question` et `approve`, et l'île ne s'ouvre plus d'elle-même (`HookServer.expandIfNeeded`, `.hookReveal`, `.musicReveal`). Une demande de permission ou une question passe toujours : un agent ne doit jamais attendre un minuteur.+- Fin : son `finish`, émote proud, puis une pause (5 min par défaut, 0 = pas de pause). L'en-tête montre « Arrêter ? » au premier clic, le second arrête.+- Concentration de macOS : une app ne peut pas l'activer. Deux raccourcis de l'app Raccourcis, nommés dans Réglages → Focus, sont lancés au début et à la fin (`/usr/bin/shortcuts run`, build GitHub).+- Temps par projet (`ProjectTime`) : sans minuteur, à chaque changement d'app au premier plan, verrouillage et veille. Éditeurs (VS Code, Cursor, Windsurf, Zed, Xcode, JetBrains, Sublime) : projet tiré du titre de la fenêtre (Accessibilité). Terminal : dossier de la session d'agent qui y tourne. Plus de 5 min sans clavier ni souris ne comptent pas. `Application Support/NotchBuddy/projecttime.json`, 90 jours.++## 17. Capture d'écran pour Claude (build GitHub)++- ⌃⌥X : l'île se replie, puis la sélection de macOS (`screencapture -i -x -o`) : zone, Espace pour une fenêtre, Échap pour annuler. Première fois : permission Enregistrement de l'écran.+- L'image arrive dans l'île (vue `.capture`) : son `gulp`, Mochi avale. Boutons : **Coller** (dans l'app où on était : ⌘V, ou ⌃V dans un terminal pour Claude Code ; le presse-papiers reprend son contenu après 1,5 s), **Copier**, **Annoter** (fenêtre : flèche, cadre, crayon, 4 couleurs, ⌘Z, l'image annotée revient dans l'île), **Demander à Claude** (chat de l'île, image jointe).+- Avec Flow : tant que la capture est dans l'île (3 min max), maintenir la touche de dictée colle l'image puis les mots au relâchement.+- Les captures restent dans le dossier temporaire (les 20 dernières) et ne partent vers Claude que si on les colle ou qu'on demande à Claude.