Dokumentacja
Instalacja i zrozumienie
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 ciebie:
~/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. |
| 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 |
Aktywacja licencji
Po zakupie otrzymasz wiadomość z przyciskiem, który otwiera aplikację i wprowadza licencję. Jeśli to nie zadziała: Ustawienia → Licencja → wklej klucz → 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>