Documentazione
Installare e capire
Installazione
Scarichi l'archivio, trascini AItention.app in
Applicationse la avvii. L'applicazione è firmata con un Developer ID e notarizzata da Apple: non compare alcun avviso.
Gli hook di stato
Senza hook l'applicazione può elencare quali sessioni sono in corso, ma non
che cosa stiano facendo. Al primo avvio propone di configurarli: aggiunge voci in ~/.claude/settings.json che richiamano un programma incluso. Quel programma scrive un file di stato e nient'altro.
Prima di ogni modifica a quel file viene creata una copia. Tutte le voci sono contrassegnate con
# aitention così che la rimozione non tocchi mai hook configurati da lei:
~/Applications/AItention.app/Contents/MacOS/AItention --uninstall-hooks
Gli stati
| Stato | Significato |
|---|---|
| Decisione | Claude ha posto una domanda con opzioni. |
| In attesa | È in sospeso una domanda o un permesso. |
| Errore | Il turno è fallito per un errore dell'API: sovraccarico, limite di frequenza, fatturazione. |
| Fatto | Il turno è finito, la risposta non è stata letta. |
| Al lavoro | Un prompt è in esecuzione, si eseguono strumenti. |
| Pronta | Sessione aperta, nessun turno attivo. |
| Inattiva | Conclusa, ma riprendibile con claude --resume. |
Se una sessione al lavoro tace per più di trenta minuti, perde il colore e mostra da quanto è silenziosa. Una visualizzazione superata che appare sicura induce in errore in modo più costoso di una che ammette di non sapere.
Da dove vengono i dati
Tutto ciò che l'applicazione mostra proviene da questi file. Nulla di ciò lascia la macchina.
| File | A che serve |
|---|---|
~/.claude/sessions/<pid>.json | Quali sessioni sono in corso, la loro directory di lavoro e la provenienza |
~/.claude/aitention/status/<id>.json | Lo stato dal vivo, scritto dall'hook: l'unico file che AItention crea da sé |
~/.claude/projects/…/<id>.jsonl | Trascrizioni: risposte, chiamate a strumenti, token |
~/.claude/tasks/<id>/ | L'elenco attività di una sessione, se ne tiene uno |
~/Library/Application Support/Claude/… | Titolo, modello e modalità delle sessioni desktop, oltre all'uso dei limiti |
Attivare una licenza
Dopo l'acquisto riceve un messaggio con un pulsante che apre l'applicazione e vi inserisce la licenza. Se non funziona: Impostazioni → Licenza → incollare la chiave → Attiva. Non viene stabilita alcuna connessione.
Quando qualcosa non torna
L'output diagnostico mostra ciò che l'applicazione vede senza avviare l'interfaccia, inclusi tutti i percorsi e lo stato degli hook:
~/Applications/AItention.app/Contents/MacOS/AItention --dump
Per verificare una chiave di licenza: --verify-licence <key>