syncing-memory-filesystem

Skill do obsługi repozytoriów pamięci wspieranej przez Git. Włącz go, gdy pracujesz z agentami mającymi pamięć przechowywana w Git, konfigurujesz zdalne repozytoria pamięci, rozwiązujesz konflikty synchronizacji lub zarządzasz pamięcią przez przepływy pracy Git. Pamięć agenta jest przechowywana w chmurze (GCS) i dostępna przez API Letta, z dwukierunkową synchronizacją między API a Git (opóźnienie około 2-3 sekund). Bloki pamięci są organizowane w strukturze katalogów memory/system/ jako pliki markdown.

1. Załaduj skill syncing-memory-filesystem do agenta, który chcesz wyposażyć w pamięć wspieraną przez Git. CLI Letta automatycznie doda tag git-memory-enabled do agenta, co wyzwoli utworzenie repozytorium Git na backendzie.

2. CLI automatycznie sklonuje repozytorium do lokalnego katalogu ~/.letta/agents/<agent-id>/memory/. Katalog ten staje się głównym katalogiem repozytorium Git, zawierającym strukturę memory/system/ dla bloków systemowych.

3. Podczas pierwszego uruchomienia CLI konfiguruje lokalny helper poświadczeń w pliku memory/.git/config, aby operacje git push i git pull działały bez konieczności ręcznego uwierzytelniania. Helper jest przechowywany na poziomie repozytorium, a nie globalnie, aby uniknąć konfliktów z innymi narzędziami.

4. CLI instaluje hook pre-commit, który waliduje nagłówek frontmatter przed każdym commitem. Zapewnia to spójność struktury plików pamięci.

5. Podczas sesji agenta CLI okresowo sprawdza status repozytorium (git status) i przypomina agentowi o zacommitowaniu i wypchnięciu zmian, jeśli repozytorium ma niezacommitowane zmiany.

6. Jeśli którykolwiek z automatycznych kroków się nie powiedzie, możesz ręcznie powtórzyć konfigurację, postępując zgodnie z dokumentacją w README — przede wszystkim upewnij się, że używasz jednoliniowego formatu dla helpera poświadczeń, ponieważ wieloliniowe helpery mogą przerwać parsowanie przez narzędzia Git.