session-memory

Persistent memory toolkit for AI agents. Save context, recall insights, track decisions across sessions.

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.