Dokumentacja — AItention

Instalacja

Pobierz archiwum, przeciągnij AItention.app do Applicationsi uruchom. Aplikacja jest podpisana identyfikatorem Developer ID i notaryzowana przez Apple — żadne ostrzeżenie się nie pojawia.

Hooki stanu

Bez hooków aplikacja potrafi wymienić, które sesje działają, ale nie to, co robią. Przy pierwszym uruchomieniu proponuje ich instalację: dopisuje wpisy do ~/.claude/settings.json które wywołują dołączony program. Ten zapisuje plik stanu i nic poza tym.

Przed każdą zmianą tego pliku powstaje kopia zapasowa. Wszystkie wpisy są oznaczone # aitention aby ich usunięcie nigdy nie naruszyło hooków skonfigurowanych przez Państwa:

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

Stany

Stan	Znaczenie
Decyzja	Claude zadał pytanie z opcjami do wyboru.
Czeka	Oczekuje pytanie lub zgoda.
Błąd	Tura zakończyła się błędem API — przeciążenie, limit zapytań, rozliczenie.
Gotowe	Tura zakończona, odpowiedź nieprzeczytana.
Pracuje	Trwa polecenie, wykonywane są narzędzia.
Podagenci	Działają podagenci, agent główny czeka na nich — nie na Państwa.
Pobudka	Czeka na pobudkę wyznaczoną samodzielnie — nie na Państwa.
Gotowa	Sesja otwarta, żadna tura nie trwa.
Uśpiona	Zakończona, ale wznawialna przez `claude --resume`.

Jeśli pracująca sesja milczy dłużej niż trzydzieści minut, traci kolor i pokazuje, jak długo już milczy. Nieaktualne wskazanie, które wygląda pewnie, myli drożej niż takie, które przyznaje się do niewiedzy.

Skąd pochodzą dane

Wszystko, co aplikacja pokazuje, pochodzi z tych plików. Nic z tego nie opuszcza komputera.

Plik	Do czego
`~/.claude/sessions/<pid>.json`	Które sesje działają, ich katalog roboczy i pochodzenie
`~/.claude/aitention/status/<id>.json`	Stan na bieżąco, zapisywany przez hook — jedyny plik, który AItention tworzy sam
`~/.claude/projects/…/<id>.jsonl`	Transkrypcje: odpowiedzi, wywołania narzędzi, tokeny
`~/.claude/tasks/<id>/`	Lista zadań sesji, jeśli ją prowadzi
`~/Library/Application Support/Claude/…`	Tytuł, model i tryb sesji desktopowych oraz wykorzystanie limitów
`~/.codex/sessions/…/rollout-*.jsonl`	Sesje Codex: tytuł, projekt, stan, kontekst i zużycie
`~/.codex/session_index.jsonl`	Nazwy, które Codex nadaje swoim sesjom
`~/.claude/history.jsonl`	Własne prompty użytkownika — podstawa wyszukiwania w promptach

Poprzednie sesje i wyszukiwanie w promptach

„Poprzednie sesje” wymieniają wszystko, co da się wznowić — także po restarcie. Uporządkowane według aplikacji lub projektu, z siedmiu dni, z trzydziestu dni albo z całego okresu, z polem wyszukiwania. W każdym wierszu jedno kliknięcie wkłada do schowka pełne polecenie: cd <katalog projektu> && claude --resume <id> albo codex resume <id>. Katalog projektu należy do niego — bez niego żadne z obu narzędzi nie odnajdzie swojej sesji.

Gdy nazwa nie wraca, szukaj we własnych promptach. Przeszukiwany jest ~/.claude/history.jsonl; trafienie prowadzi do odpowiedniej sesji, a polecenie wznowienia stoi obok.

Codex

Sesje Codex pojawiają się na tej samej liście co sesje Claude Code — z ikoną programu, w którym działają, oraz z projektem, kontekstem i zużyciem. Od dwóch narzędzi wzwyż dochodzi grupowanie według narzędzia. W instalacji Codex nic się nie zmienia: Codex prowadzi własny zapis dla każdej sesji, AItention go czyta i do niego nie pisze.

Jedno ograniczenie. Stanu „czeka na Państwa” AItention dla Codex nie zgłasza. Claude Code przekazuje go przez hak stanu; w zapisach Codex nie znaleźliśmy dotąd odpowiedniego zdarzenia. Sesje Codex pojawiają się więc jako pracujące, gotowe albo nieudane. Gdy takie zdarzenie się pojawi, stan dojdzie.

Aktywacja licencji

Po zakupie otrzymają Państwo wiadomość z przyciskiem, który otwiera aplikację i wprowadza licencję. Jeśli to nie zadziała: Ustawienia → Licencja → wklejenie klucza → Aktywuj. Żadne połączenie nie jest nawiązywane.

Gdy coś się nie zgadza

Wydruk diagnostyczny pokazuje, co widzi aplikacja, bez uruchamiania interfejsu — łącznie ze wszystkimi ścieżkami i stanem hooków:

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

Aby sprawdzić klucz licencyjny: --verify-licence <key>

Instalacja i zrozumienie