Skip to content

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.

Spec: Mochi and the Mac, Focus, screen capture

Claude5ad0083ea9e8
diff --git a/docs/SPEC.md b/docs/SPEC.md
index 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.