Notifications and the phone appNotifications et application téléphone
Desktop notifications, the face of the icon, and the Android app that follows your sessions from your phone.Notifications du bureau, visage de l'icône, et l'application Android qui suit vos sessions depuis votre téléphone.
1. Desktop notificationsNotifications du bureau
The settings page Notifications turns all of them on or off, chooses when (unfocused: only when claude-cluster is not in front, always), each kind (the global session answered, a session finished, a permission, a question, an error, the limits, the web devices, the task queue, reminders, something slow ready) and the sound. A notification clicked (its body or Open) shows its session. Never twice: whoever sent the last prompt of a session is notified for it, here or on the web device that sent it. One notification per session, urgent when it waits on you, with buttons answered from the notification (a question's options, Allow / Deny).
La page de réglages Notifications les active ou désactive toutes, choisit quand (unfocused : seulement quand claude-cluster n'est pas au premier plan, always), chaque genre (la session globale a répondu, une session a fini, une permission, une question, une erreur, les limites, les appareils web, la file de tâches, les rappels, quelque chose de lent est prêt) et le son. Une notification cliquée (son corps ou Open) montre sa session. Jamais deux fois : celui qui a envoyé le dernier prompt d'une session est notifié pour elle, ici ou sur l'appareil web qui l'a envoyé. Une notification par session, urgente quand elle vous attend, avec des boutons dont la réponse part de la notification (les options d'une question, Allow / Deny).
2. The face of the iconLe visage de l'icône
The icon is a stack of terminals whose front one has a face made of prompt characters; the face follows what claude-cluster does, in the title of the terminal, the window icon, the tab of the web page, the dock (the number of sessions waiting on you, else running) and claude-cluster icon [face] [badge] (its SVG, for a status bar).
| Face | The app now |
|---|---|
^_^ happy | the global session just answered |
>‿< grin | a session just finished |
•_• attentive | a question or a permission waits, the voice listens |
o_o waiting | an error, the safety check of Claude Code |
-_- idle | nothing running |
>_< squint | something running |
L'icône est une pile de terminaux dont celui de devant a un visage fait de caractères de prompt ; le visage suit ce que fait claude-cluster, dans le titre du terminal, l'icône de la fenêtre, l'onglet de la page web, le dock (le nombre de sessions qui vous attendent, sinon en cours) et claude-cluster icon [visage] [badge] (son SVG, pour une barre d'état).
| Visage | L'application maintenant |
|---|---|
^_^ happy | la session globale vient de répondre |
>‿< grin | une session vient de finir |
•_• attentive | une question ou une permission attend, la voix écoute |
o_o waiting | une erreur, le contrôle de sécurité de Claude Code |
-_- idle | rien ne tourne |
>_< squint | quelque chose tourne |
3. The Android appL'application Android
When the web access is open, the page offers an app at /app.apk. It is built by android/build.sh (the Android SDK alone, no Gradle) and signed by a key of your own, ~/.config/claude-cluster/android/release.jks.
- It is the web page in a thin shell: the computer is trusted once (its authority pinned after its fingerprint is shown and compared, so no warning), the microphone and the notifications work, it is edge to edge on Android 15.
- Tabs: Chat (the last chat opened, the global session first), Sessions, This device (version, build, this phone; Check for updates: installed from your computer, nothing to download elsewhere; per-phone notification kinds).
- An app older than the one the computer serves is blocked by a popup until updated (Install); a newer one on the computer is offered, never an older one; an app too old for this claude-cluster says so.
Quand l'accès web est ouvert, la page propose une application sur /app.apk. Elle est compilée par android/build.sh (le seul SDK Android, sans Gradle) et signée par une clé à vous, ~/.config/claude-cluster/android/release.jks.
- C'est la page web dans une coque légère : l'ordinateur est approuvé une fois (son autorité épinglée après que son empreinte a été montrée et comparée, donc sans avertissement), le micro et les notifications fonctionnent, plein écran sur Android 15.
- Onglets : Chat (le dernier chat ouvert, la session globale d'abord), Sessions, This device (version, build, ce téléphone ; Check for updates : installée depuis votre ordinateur, rien à télécharger ailleurs ; genres de notifications par téléphone).
- Une application plus ancienne que celle que sert l'ordinateur est bloquée par une fenêtre jusqu'à sa mise à jour (Install) ; une plus récente sur l'ordinateur est proposée, jamais une plus ancienne ; une application trop ancienne pour ce claude-cluster le dit.
4. Phone notificationsNotifications du téléphone
The app shows every notification of the desktop. The core logs each one (the last 100, kinds and [ui] notify_* as on the desktop) and the app follows that log by a long poll, GET /api/notify?since=N (answered at once on a new one, else after 25 s). [ui] notify_app = false publishes none. Each phone chooses for itself in This device: on / off and which kinds, Send a test, Allow notifications (Android 13+, POST_NOTIFICATIONS) and Keep running in the background.
They show while the app is not in front, in Android channels per family (Waiting for you, Sessions, Errors and limits, Reminders and messages: high; Information: low), grouped per session, a tap opens that session. The logo is the status bar icon (a flat white mask generated at every density) and the large icon.
There are no Google services, so no push: a foreground service keeps its own connection to the computer (a quiet following your sessions notification, started when the app leaves the front and after a boot or an update, reconnecting with a growing delay). It cannot reach a computer that is off or out of the network, cannot survive an Android that kills the service despite the battery exemption (some vendors do: allow autostart), and cannot answer a permission from the notification (it opens the session). Away from home use the web access Beyond the LAN with Tailscale (Security).
L'application montre chaque notification du bureau. Le cœur journalise chacune (les 100 dernières, genres et [ui] notify_* comme sur le bureau) et l'application suit ce journal par une longue interrogation, GET /api/notify?since=N (réponse immédiate s'il y en a une nouvelle, sinon après 25 s). [ui] notify_app = false n'en publie aucune. Chaque téléphone choisit pour lui dans This device : activé / désactivé et quels genres, Send a test, Allow notifications (Android 13+, POST_NOTIFICATIONS) et Keep running in the background.
Elles s'affichent quand l'application n'est pas au premier plan, dans des canaux Android par famille (Waiting for you, Sessions, Errors and limits, Reminders and messages : haute ; Information : basse), groupées par session, un appui ouvre cette session. Le logo est l'icône de la barre d'état (un masque blanc plat généré à chaque densité) et la grande icône.
Il n'y a aucun service Google, donc pas de push : un service d'avant-plan garde sa propre connexion à l'ordinateur (une discrète notification following your sessions, lancée quand l'application quitte le premier plan et après un redémarrage ou une mise à jour, se reconnectant avec un délai croissant). Il ne peut pas joindre un ordinateur éteint ou hors réseau, ne survit pas à un Android qui tue le service malgré l'exemption batterie (certains constructeurs le font : autorisez le démarrage automatique), et ne peut pas répondre à une permission depuis la notification (elle ouvre la session). Loin de chez vous, utilisez l'accès web Beyond the LAN avec Tailscale (Sécurité).