Documentation — AItention

Installation

Téléchargez l'archive, glissez AItention.app dans Applications, lancez-la. L'application est signée avec un Developer ID et notarisée par Apple — aucun avertissement n'apparaît.

Les hooks d'état

Sans les hooks, l'application peut lister quelles sessions tournent, mais pas ce que elles font. Au premier lancement, elle propose de les installer : elle ajoute des entrées dans ~/.claude/settings.json qui appellent un programme fourni. Celui-ci écrit un fichier d'état et rien d'autre.

Une sauvegarde est faite avant chaque modification de ce fichier. Toutes les entrées portent la marque # aitention afin que leur retrait ne touche jamais des hooks que vous avez configurés vous-même :

~/Applications/AItention.app/Contents/MacOS/AItention --uninstall-hooks

Les états

État	Signification
Décision	Claude a posé une question à choix.
En attente	Une question ou une autorisation est en suspens.
Erreur	Le tour a échoué sur une erreur d'API — surcharge, limite de débit, facturation.
Terminé	Le tour est fini, la réponse n'est pas lue.
Travaille	Une invite est en cours, des outils s'exécutent.
Sous-agents	Des sous-agents tournent, l'agent principal les attend — pas vous.
Réveil	Attend un réveil qu'elle s'est donné elle-même — pas vous.
Prêt	Session ouverte, aucun tour actif.
En veille	Terminée, mais reprenable avec `claude --resume`.

Si une session au travail reste muette plus de trente minutes, elle perd sa couleur et indique depuis combien de temps elle se tait. Un affichage périmé qui a l'air sûr de lui induit plus coûteusement en erreur qu'un affichage qui admet ne pas savoir.

D'où viennent les données

Tout ce que l'application affiche provient de ces fichiers. Rien n'en sort de la machine.

Fichier	À quoi
`~/.claude/sessions/<pid>.json`	Quelles sessions tournent, leur répertoire de travail et leur origine
`~/.claude/aitention/status/<id>.json`	L'état en direct, écrit par le hook — le seul fichier qu'AItention crée lui-même
`~/.claude/projects/…/<id>.jsonl`	Transcriptions : réponses, appels d'outils, jetons
`~/.claude/tasks/<id>/`	La liste de tâches d'une session, si elle en tient une
`~/Library/Application Support/Claude/…`	Titre, modèle et mode des sessions de bureau, ainsi que l'usage des quotas
`~/.codex/sessions/…/rollout-*.jsonl`	Sessions Codex : titre, projet, état, contexte et consommation
`~/.codex/session_index.jsonl`	Les noms que Codex donne à ses sessions
`~/.claude/history.jsonl`	Vos propres prompts — la base de la recherche de prompts

Sessions précédentes et recherche de prompts

« Sessions précédentes » répertorie tout ce qui peut être repris — même après un redémarrage. Classées par application ou par projet, sur sept jours, trente jours ou toute la période, avec un champ de recherche. Sur chaque ligne, un clic place la commande complète dans le presse-papiers : cd <dossier de projet> && claude --resume <id> ou codex resume <id>. Le dossier de projet en fait partie — sans lui, aucun des deux outils ne retrouve sa session.

Si le nom vous échappe, cherchez plutôt dans vos propres prompts. C'est ~/.claude/history.jsonl qui est parcouru ; le résultat mène à sa session, et la commande de reprise se trouve à côté.

Codex

Les sessions Codex figurent dans la même liste que celles de Claude Code — avec l'icône de l'application où elles tournent, avec projet, contexte et consommation. À partir de deux outils s'ajoute un regroupement par outil. Rien ne change dans votre installation Codex : Codex tient son propre enregistrement par session, AItention le lit et n'y écrit pas.

Une limite. AItention ne signale pas l'état « attend votre réponse » pour Codex. Claude Code le communique par le hook d'état ; dans les enregistrements de Codex, nous n'avons pas encore trouvé d'événement correspondant. Les sessions Codex apparaissent donc comme actives, terminées ou en échec. Dès qu'un tel événement apparaîtra, l'état suivra.

Activer une licence

Après l'achat, vous recevez un courriel avec un bouton qui ouvre l'application et y inscrit la licence. Si cela ne fonctionne pas : Réglages → Licence → coller la clé → Activer. Aucune connexion n'est établie.

Quand quelque chose cloche

La sortie de diagnostic montre ce que voit l'application sans lancer l'interface — y compris tous les chemins et l'état des hooks :

~/Applications/AItention.app/Contents/MacOS/AItention --dump

Pour vérifier une clé de licence : --verify-licence <key>

Installer et comprendre