cc-history

Narzędzie referencyjne do przeszukiwania i analizy plików historii konwersacji Claude Code. Umożliwia wyodrębnianie informacji z plików JSONL przechowywanych w katalogu ~/.claude/projects/ za pomocą standardowych poleceń powłoki i narzędzia jq. Zawiera dokumentację struktury katalogów, reguł kodowania ścieżek projektów, typów wiadomości (user, assistant, system, queue-operation) oraz formatu obiektu wiadomości z metadanymi takimi jak UUID, znacznik czasu, ID sesji i statystyki użycia tokenów.

1. Zlokalizuj katalog projektu Claude Code. Twoja historia konwersacji znajduje się w ~/.claude/projects/ w podkatalogach zakodowanych na podstawie ścieżki roboczej. Aby znaleźć poprawną ścieżkę, przekonwertuj bieżący katalog roboczy, zamieniając wiodący ukośnik na myślnik, pozostałe ukośniki na myślniki, a sekwencje /. (ukryte katalogi) na podwójne myślniki.
2. Otwórz plik JSONL sesji. Główny plik konwersacji ma nazwę {session-uuid}.jsonl i znajduje się bezpośrednio w katalogu projektu. Każda linia tego pliku to jeden obiekt JSON reprezentujący wiadomość.
3. Użyj jq do filtrowania wiadomości. Aby wyodrębnić konkretne informacje, zastosuj polecenia jq na pliku JSONL. Na przykład możesz filtrować po typie wiadomości (user, assistant, system), UUID, znaczniku czasu lub zawartości wiadomości.
4. Sprawdź strukturę wiadomości asystenta. Odpowiedzi modelu mogą zawierać bloki treści o różnych typach: thinking (myślenie modelu), tool_use (użycie narzędzia) i text (tekst). Metadane zawierają również statystyki tokenów, w tym cache_read_input_tokens i cache_creation_input_tokens.
5. Przeanalizuj rozmowy podagentów (opcjonalnie). Jeśli projekt zawiera podagentów, ich rozmowy znajdują się w plikach JSONL w podkatalogu subagents/ (agent-{hash}.jsonl). Duże wyniki narzędzi są przechowywane osobno w katalogu tool-results/.