Documentazione — AItention

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.
Sottoagenti	Sono in corso sottoagenti, l'agente principale attende loro — non lei.
Sveglia	Attende una sveglia che si è data da sola — non lei.
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
`~/.codex/sessions/…/rollout-*.jsonl`	Sessioni Codex: titolo, progetto, stato, contesto e consumo
`~/.codex/session_index.jsonl`	I nomi che Codex dà alle sue sessioni
`~/.claude/history.jsonl`	I 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>

Installare e capire