Dokumentation — AItention

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.
Unteragenten	Unteragenten laufen, der Hauptagent wartet auf sie — nicht auf Sie.
Weckruf	Wartet auf einen selbst gestellten Weckruf — nicht auf Sie.
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
`~/.codex/sessions/…/rollout-*.jsonl`	Codex-Sessions: Titel, Projekt, Zustand, Kontext und Verbrauch
`~/.codex/session_index.jsonl`	Die Namen, die Codex seinen Sessions gibt
`~/.claude/history.jsonl`	Ihre eigenen Prompts — Grundlage der Prompt-Suche

Andere Werkzeuge anschließen

AItention liest je Session eine kleine JSON-Datei unter ~/.claude/aitention/status/<session-id>.json. Für Claude Code schreibt der mitgelieferte Hook sie. Jedes andere Werkzeug, das bei Ereignissen ein Programm starten kann, darf dasselbe tun — und erscheint dann in der Liste, ohne dass an AItention etwas geändert werden muss.

Der Vertrag ist veröffentlicht und wird bei jedem Bau gegen den Quelltext geprüft: aitention.app/schema/status-v1.json. Pflicht sind drei Felder — session_id, state und ts. Mit agent trägt sich ein Werkzeug ein (claude, codex oder ein eigener Bezeichner); fehlt das Feld, gilt claude. Laufen mehrere Werkzeuge, erscheint in der Liste eine vierte Gruppierung.

Was Sie schreiben, zeigt AItention — mehr nicht. Es startet nichts, wertet nichts aus und schickt nichts weiter.

Vorige Sitzungen und Prompt-Suche

„Vorige Sitzungen“ listet alles auf, was sich fortsetzen lässt — auch über einen Neustart hinweg. Geordnet nach Programm oder Projekt, über sieben Tage, dreißig Tage oder den ganzen Zeitraum, mit Suchfeld. Je Zeile legt ein Klick den vollständigen Befehl in die Zwischenablage: cd <Projektordner> && claude --resume <id> beziehungsweise codex resume <id>. Der Projektordner gehört dazu — ohne ihn findet keines der beiden Werkzeuge seine Session.

Wissen Sie den Namen nicht mehr, suchen Sie stattdessen in Ihren eigenen Prompts. Durchsucht wird ~/.claude/history.jsonl; der Treffer führt zu seiner Session, und der Befehl zum Fortsetzen steht daneben.

Codex

Codex-Sessions erscheinen in derselben Liste wie die von Claude Code — mit dem Symbol des Programms, in dem sie laufen, mit Projekt, Kontext und Verbrauch. Ab zwei Werkzeugen kommt eine Gruppierung nach Werkzeug dazu. An Ihrer Codex-Einrichtung ändert sich nichts: Codex führt je Session eine eigene Aufzeichnung, AItention liest sie und schreibt nicht hinein.

Eine Einschränkung. Den Zustand „wartet auf Sie“ meldet AItention für Codex nicht. Claude Code teilt ihn über den Status-Hook mit; in den Aufzeichnungen von Codex haben wir bislang kein entsprechendes Ereignis gefunden. Codex-Sessions erscheinen deshalb als arbeitend, fertig oder gescheitert. Sobald ein solches Ereignis auftaucht, kommt der Zustand dazu.

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>

Einrichten und verstehen