Installation

Archiv laden, AItention.app nach Programme ziehen, starten. Die App ist mit einer Developer-ID signiert und von Apple notarisiert — es erscheint keine Warnung.

Die Status-Hooks

Ohne Hooks kann die App auflisten, welche Sessions laufen, aber nicht, was sie tun. Beim ersten Start bietet sie an, sie einzurichten; dabei trägt sie Einträge in ~/.claude/settings.json ein, die ein mitgeliefertes Programm aufrufen. Das schreibt eine Statusdatei und tut sonst nichts.

Vor jeder Änderung an dieser Datei wird eine Sicherung angelegt. Alle Einträge sind mit # aitention markiert, damit das Entfernen niemals fremde Hooks trifft:

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

Die Zustände

Zustand	Bedeutung
Entscheidung	Claude hat eine Frage mit Auswahlmöglichkeiten gestellt.
Wartet	Eine Rückfrage oder Berechtigung steht an.
Fehler	Der Turn ist an einem API-Fehler gescheitert — Überlastung, Ratenlimit, Abrechnung.
Fertig	Der Turn ist beendet, die Antwort ungelesen.
Arbeitet	Ein Prompt läuft, Werkzeuge werden ausgeführt.
Bereit	Session offen, gerade kein Turn aktiv.
Ruhend	Beendet, aber mit `claude --resume` fortsetzbar.

Meldet sich eine arbeitende Session länger als dreißig Minuten nicht, verliert sie ihre Farbe und zeigt stattdessen, wie lange sie schon schweigt. Eine veraltete Anzeige, die zuversichtlich aussieht, ist schlimmer als eine, die ihre Unwissenheit zugibt.

Woher die Daten kommen

Alles, was die App zeigt, stammt aus diesen Dateien. Nichts davon verlässt den Rechner.

Datei	Wofür
`~/.claude/sessions/<pid>.json`	Welche Sessions laufen, Arbeitsverzeichnis, Herkunft
`~/.claude/aitention/status/<id>.json`	Der Live-Zustand, geschrieben vom Hook — die einzige Datei, die AItention selbst anlegt
`~/.claude/projects/…/<id>.jsonl`	Transcripts: Antworten, Tool-Aufrufe, Tokens
`~/.claude/tasks/<id>/`	Die Aufgabenliste einer Session, sofern sie eine führt
`~/Library/Application Support/Claude/…`	Titel, Modell und Modus der Desktop-Sessions, Auslastung der Ratenfenster

Lizenz aktivieren

Nach dem Kauf kommt eine Mail mit einem Knopf, der die App öffnet und die Lizenz einträgt. Falls das nicht klappt: Einstellungen → Lizenz → Schlüssel einfügen → Aktivieren. Es wird keine Verbindung aufgebaut.

Wenn etwas nicht stimmt

Die Diagnoseausgabe zeigt, was die App sieht, ohne die Oberfläche zu starten — inklusive aller Pfade und des Hook-Status:

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

Einen Lizenzschlüssel prüfen: --verify-licence <schlüssel>