session-memory

Zestaw narzędzi do zarządzania pamięcią agentów AI. Zapisuj spostrzeżenia z poziomami ważności, wyszukuj po słowach kluczowych z oceną trafności, ładuj kontekst sesji, konsoliduj wiedzę i eksportuj dane. Narzędzie działa w czystym bashu i Node.js bez dodatkowych zależności. Idealne do śledzenia decyzji, insightów i kontekstu między sesjami pracy agenta.

1. Zainstaluj narzędzie, klonując repozytorium i upewniając się, że masz zainstalowany Node.js. Ustaw zmienną środowiskową AGENT_MEMORY_DIR na katalog, w którym chcesz przechowywać pamięć (domyślnie ~/.agent-memory).

2. Zapisz pierwszą pamięć, uruchamiając skrypt save.sh z tematem i treścią. Na przykład: ./scripts/save.sh "insight" "Użytkownicy preferują tryb ciemny 3:1". Możesz dodać tagi i ustawić poziom ważności zmienną MEMORY_IMPORTANCE (low, normal, high, critical).

3. Przywołaj zapisane wspomnienia za pomocą recall.sh, podając zapytanie wyszukiwania. Narzędzie zwraca wyniki z oceną trafności i obsługuje wiele słów kluczowych (wszystkie muszą się zgadzać). Użyj flagi --limit, aby ograniczyć liczbę wyników, lub --importance, aby filtrować po poziomie ważności.

4. Załaduj kontekst sesji na starcie agenta, uruchamiając context.sh. Skrypt pobiera wspomnienia z ostatnich dni (domyślnie 3) i zawsze wyświetla pamięci oznaczone jako critical, niezależnie od daty.

5. Konsoliduj wiedzę tematycznie za pomocą consolidate.sh, aby pogrupować powiązane wspomnienia. Możesz filtrować po dacie początkowej (--since YYYY-MM-DD), aby pracować tylko z nowszymi wpisami.

6. Sprawdzaj statystyki pamięci, uruchamiając stats.sh, aby zobaczyć liczbę wpisów, rozkład ważności i inne metryki. Eksportuj i importuj pamięć w formacie JSON, aby przenosić dane między systemami lub tworzyć kopie zapasowe.