Czytaj Kontekst — pamięć agenta (plugin Claude Code)

Prosty, polski system pamięci dla Twojego agenta (Claude Code). Daje mu trwałą pamięć: kim jest, kogo obsługujesz, czego ma nie powtarzać — w zwykłych plikach .md, wczytywanych na żądanie. Dla osób nietechnicznych. Bez kluczy API, bez kosztów.

Materiał do Lekcji 2 kursu „Czytaj Kontekst". Pełne wyjaśnienie jest w nagraniu lekcji.

• Claude Code (wersja 2.1.143 lub nowsza — sprawdź /version).
• Git — na Windowsie zainstaluj wg instrukcji z lekcji (winget install Git.Git). Na Macu zwykle już jest.
• Python — TYLKO jeśli chcesz wyszukiwanie po znaczeniu (na Windowsie: winget install Python.Python.3.12). Reszta działa bez Pythona.

Komendy z / wpisujesz w Claude Code. Komendę winget w Git Bash (Windows).

1. /plugin marketplace add studiogo/czytaj-kontekst Dodaje repozytorium z pluginem (pobiera je przez Gita). Robisz to raz.

2. /plugin install pamiec-agenta@czytaj-kontekst Instaluje plugin i sam wpina hooki: samouczenie + wczytywanie reguł na starcie. Gdyby nie złapał od razu — wpisz /reload-plugins.

3. /zbuduj-pamiec Tworzy pliki pamięci w ~/.claude/pamiec. Twojego CLAUDE.md, jeśli już istnieje, nie nadpisze.

4. winget install Python.Python.3.12 (Windows; na Macu Python zwykle już jest) Instaluje Pythona — potrzebuje go baza, żeby zapisywać i szukać kontekstu po znaczeniu. Po instalacji zamknij i otwórz terminal.

5. /wlacz-szukanie-znaczeniowe Buduje bazę kontekstu: mały lokalny model (~30 MB), bez Ollamy i bez klucza. Od teraz działa /szukaj-znaczenie "...".

Po tych 5 krokach masz komplet: pamięć + samouczenie + baza do szukania po znaczeniu.

Komendy z / wpisujesz w Claude Code, komendy find/python w Git Bash (Windows) lub Terminalu (Mac).

1. /hooks Mają pojawić się dwa wpisy: SessionStart → wczytaj-uwagi.sh i Stop → naucz-sie.py. To znaczy, że plugin wpiął się sam.

2. Powiedz agentowi regułę + „zapisz poprawkę", potem /clear i zapytaj o nią Po wyczyszczeniu rozmowy agent dalej ma znać tę regułę. To znaczy, że pamięć wraca między sesjami.

3. find ~/.claude -name naucz-sie.py → potem python "<ścieżka>" --teraz Najpierw popraw agenta zwykłym zdaniem (bez „zapisz poprawkę"), potem odpal te dwie komendy. Wypisze „Nauczyłem się…" — czyli samouczenie działa samo.

4. /szukaj-znaczenie "..." (opcjonalnie) Działa, jeśli wcześniej włączyłeś /wlacz-szukanie-znaczeniowe. Zapytaj innymi słowami niż w notatkach — ma trafić w dobrą notatkę.

• CLAUDE.md — tożsamość agenta (uzupełnij o siebie). Tylko jeśli jeszcze go nie masz.
• pamiec/MEMORY.md — mapa (drogowskazy, nie magazyn).
• pamiec/uwagi.md — reguły z Twoich poprawek (wczytują się na starcie każdej sesji).
• pamiec/klienci/przyklad-klienta.md — wzór notatki o kliencie.
• pamiec/JAK-TO-DZIALA.md — krótka instrukcja.

• Pamięć na żądanie: w MEMORY.md trzymasz tylko drogowskazy; szczegóły klienta agent czyta, gdy temat wraca.
• Uczenie (automatyczne): po turze plugin sam wyłapuje Twoje poprawki z rozmowy i dopisuje je jako reguły do uwagi.md (Haiku, keyless). Możesz też dopisać ręcznie: „zapisz poprawkę" (/zapisz-poprawke). Reguły wczytują się na starcie każdej sesji.
• Higiena: raz w tygodniu „przejrzyj uwagi" (/przejrzyj-uwagi).
• Historia rozmów: „szukaj w historii" (/szukaj-historii) — agent przeszukuje Twoje wcześniejsze rozmowy po słowie-kluczu/dacie i streszcza, o czym była mowa.

• Plugin uczy się sam: po turze (throttle ~30 min) wyłapuje Twoje poprawki z rozmowy i dopisuje reguły do uwagi.md (lokalny claude -p, Haiku, keyless), które wczytują się na starcie kolejnej sesji.
• Natywna auto-pamięć Claude Code (od 2.1.59) działa OBOK: sama zapisuje korekty/preferencje do ~/.claude/projects/<projekt>/memory/ i przypomina na starcie. Bez klucza, na Windowsie też.

Plugin dokłada do tego: Twoje widoczne, edytowalne reguły (uwagi.md) + mapę na żądanie + szukanie (po słowie i po znaczeniu).

/szukaj-historii szuka po słowie-kluczu. Szukanie po ZNACZENIU (gdy nie pamiętasz dokładnego słowa) włączasz RAZ komendą /wlacz-szukanie-znaczeniowe — stawia mały lokalny model (~30 MB), bez Ollamy, bez klucza API. Potem szukasz: /szukaj-znaczenie "<o co chodzi>". Indeksuje pliki pamięci; żeby dołączyć dawne rozmowy, poproś o odświeżenie indeksu z rozmowami. Wymaga zainstalowanego Pythona.

Robi: pamięta Twoje reguły i wczytuje je sam na starcie; trzyma wiedzę o klientach do doczytania na żądanie; pozwala przeszukać dawne rozmowy. Nie robi: nie wysyła nic na zewnątrz — auto-łapanie poprawek działa lokalnie, przez Twój własny Claude Code (claude -p, keyless), nie przez zewnętrzne API.

Nie wpisuj haseł ani kluczy do plików pamięci — trzymaj tylko nazwę klucza; wartość w sejfie systemu (Menedżer poświadczeń na Windowsie / Pęk kluczy na Macu) oddzielnie od notatek.

Zanim wkleisz pliki pamięci do zgłoszenia na GitHubie, pamiętaj, że siedzą tam nazwy Twoich klientów i stan Twoich projektów.

Coś nie działa albo instrukcja jest niejasna? Załóż zgłoszenie — są trzy gotowe szablony: instalacja i hooki, zachowanie pamięci, niejasny opis. Najcenniejsze zgłoszenie to „u mnie nie zadziałało” z wklejonym tekstem z ekranu.

Zanim napiszesz, zajrzyj do CONTRIBUTING.md — jest tam, co podać w zgłoszeniu i czego do tej wtyczki nie przyjmuję. Obowiązuje kodeks postępowania.

MIT — patrz LICENSE. Możesz tego używać, zmieniać i rozdawać, także w pracy zarobkowej.