Her — detektyw do analizy sesji Claude Code z lokalną obsługą AI

Deweloper Ashish Chalke stworzył narzędzie Her (hindi: „detektyw”) — analizator sesji Claude Code, który automatycznie interpretuje pliki logów w formacie .jsonl. Projekt, opisany w artykule na Hugging Face, powstał podczas weekendowego hackathonu i oferuje bezpieczną analizę działań agenta AI bez wysyłania danych do zewnętrznych API.

Kluczowe wnioski

• Her automatycznie analizuje pliki .jsonl z sesji Claude Code, tłumacząc tysiące linii JSON na zrozumiały język polski.
• Narzędzie identyfikuje ryzykowne operacje (deploy, zmiany konfiguracji, dostęp do produkcji) i wskazuje dokładny moment ich wykonania.
• Analiza odbywa się lokalnie na GPU Space'a przez model Nemotron-Mini-4B-Instruct — żadne dane nie opuszczają bezpiecznego środowiska.
• Wbudowana baza danych rozpoznaje narzędzia CLI z Homebrew, npm i PyPI, oferując kontekstowe opisy ich funkcji.
• Funkcja „Ask Her” pozwala zadawać pytania o konkretne elementy sesji z automatycznym cytowaniem źródeł.

Jak działa Her

Her rozwiązuje kluczowy problem analizy sesji Claude Code — podczas gdy każda sesja generuje szczegółowy plik .jsonl z każdym wywołaniem narzędzia i tokenem, w praktyce nikt nie czyta 4000 linii JSON-a, by zrozumieć, dlaczego agent sięgnął po produkcję lub gdzie faktycznie zużył budżet kontekstu.

Narzędzie rekonstruuje przebieg sesji w prostym języku, flaguje ryzykowne ruchy i śledzi każdy z nich z powrotem do dokładnego momentu wystąpienia. Pokazuje także, gdzie zostały wykorzystane tokeny, jakie narzędzia, subagenci i serwery MCP były używane.

Architektura i bezpieczeństwo

Kluczową cechą Her jest podział odpowiedzialności: silnik ewaluacyjny działa w sposób całkowicie deterministyczny, podczas gdy model AI służy wyłącznie do pisania tekstu po angielsku i proponowania łagodniejszych sugestii. Model nigdy nie podaje ustaleń jako fakty — liczby pozostają niezmienne niezależnie od zmian w modelu.

Sesje są przesyłane wyłącznie do prywatnej, automatycznie usuwanej przestrzeni nazw należącej do danego uruchomienia. Her nie tylko wymienia narzędzia CLI używane w sesji, ale także je identyfikuje dzięki wbudowanej bazie danych najpopularniejszych narzędzi.

Od operatora do managera

Projekt ewoluował od weekendowego pomysłu stworzonego dla znajomego — początkowo był to graf podróży, gdzie każde zapytanie stanowiło węzeł o rozmiarze proporcjonalnym do kosztu. Na prośbę innego użytkownika, który chciał prostszego rozwiązania, graf zyskał wykonawczy raport, który teraz jest domyślnym widokiem.

Her oferuje dwa tryby pracy: widok sesji po upuszczeniu jednego pliku oraz widok projektu po przesłaniu kilku plików, pozwalający śledzić pytania w wielu sesjach jednocześnie. Jak podsumowuje autor: „Kiedy Claude traci rozum, wezwij Her.”