AItention

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

StatoSignificato
DecisioneClaude ha posto una domanda con opzioni.
In attesaÈ in sospeso una domanda o un permesso.
ErroreIl turno è fallito per un errore dell'API: sovraccarico, limite di frequenza, fatturazione.
FattoIl turno è finito, la risposta non è stata letta.
Al lavoroUn prompt è in esecuzione, si eseguono strumenti.
SottoagentiSono in corso sottoagenti, l'agente principale attende loro — non lei.
SvegliaAttende una sveglia che si è data da sola — non lei.
ProntaSessione aperta, nessun turno attivo.
InattivaConclusa, ma riprendibile con claude --resume.
Il kernel di sistema di questa macchinaIl carico del processore e i tempi di processore dei programmi in esecuzione — non la loro riga di comando, non il loro percorso
~/.claude/aitention/cpu-verlauf.jsonIl carico del processore, un punto al minuto per 24 ore, con il nome del maggiore consumatore

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 — e il carico del processore dal kernel di sistema di questa macchina. Nulla di ciò lascia la macchina.

FileA che serve
~/.claude/sessions/<pid>.jsonQuali sessioni sono in corso, la loro directory di lavoro e la provenienza
~/.claude/aitention/status/<id>.jsonLo stato dal vivo, scritto dall'hook: l'unico file che AItention crea da sé
~/.claude/projects/…/<id>.jsonlTrascrizioni: 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
~/.codex/sessions/…/rollout-*.jsonlSessioni Codex: titolo, progetto, stato, contesto e consumo
~/.codex/session_index.jsonlI nomi che Codex dà alle sue sessioni
~/.claude/history.jsonlI suoi prompt, base della ricerca nei prompt

Sessioni precedenti e ricerca nei prompt

«Sessioni precedenti» elenca tutto ciò che si può riprendere, anche dopo un riavvio. Ordinate per applicazione o per progetto, su sette giorni, trenta giorni o l'intero periodo, con campo di ricerca. Su ogni riga un clic mette negli appunti il comando completo: cd <cartella di progetto> && claude --resume <id> oppure codex resume <id>. La cartella di progetto ne fa parte: senza di essa nessuno dei due strumenti ritrova la propria sessione.

Se il nome sfugge, cerchi nei suoi stessi prompt. Viene percorso ~/.claude/history.jsonl; il risultato porta alla sua sessione e il comando per riprenderla sta accanto.

Codex

Le sessioni Codex compaiono nello stesso elenco di quelle di Claude Code, con l'icona del programma in cui girano e con progetto, contesto e consumo. Da due strumenti in su si aggiunge un raggruppamento per strumento. La sua installazione di Codex non cambia: Codex tiene una propria registrazione per sessione, AItention la legge e non vi scrive.

Un limite. AItention non segnala lo stato «attende una sua risposta» per Codex. Claude Code lo comunica tramite l'hook di stato; nelle registrazioni di Codex non abbiamo ancora trovato un evento corrispondente. Le sessioni Codex compaiono perciò come attive, concluse o fallite. Non appena tale evento comparirà, lo stato seguirà.

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>