claude-memory

claude-memory

Plugin Claude Code od Xentivo sp. z o.o. — trwała, plikowa pamięć między sesjami i strukturalna mapa repozytorium. Bez zewnętrznych zależności, zero kosztów API poza samym Claude.

Repozytorium: https://github.com/xentivo/claude-plugins

Po co

• Mniej tokenów — agent nie skanuje od zera tego samego kodu w każdej sesji.
• Brak amnezji — decyzje architektoniczne i logi sesji żyją w plikach w repo.
• Mapa kodu — graph.json (linki Markdown, importy) zamiast ślepego czytania wielu plików naraz.

Skille

Po instalacji komendy mają prefiks claude-memory::

Skill	Komenda	Kiedy
resume	/claude-memory:resume	Na początku sesji — odtwarza kontekst z decisions.md i ostatnich logów
save	/claude-memory:save	Na końcu sesji — zapisuje log, ewentualną decyzję, odświeża graph.json
graph	/claude-memory:graph	Przed czytaniem wielu plików — buduje lub odpytuje mapę strukturalną repo

Pamięć (docs/claude-memory/) jest per projekt. Przy pierwszym /save plugin tworzy katalog i szablony z wbudowanych assetów.

Instalacja

W dowolnym projekcie z Claude Code:

/plugin marketplace add xentivo/claude-plugins
/plugin install claude-memory@claude-memory

Aktualizacja po zmianach w tym repo:

/plugin marketplace update

Opcjonalnie wklej sekcję „Pamięć Claude” z CLAUDE.md do ~/.claude/CLAUDE.md, żeby agent pamiętał o /resume i /save globalnie.

Typowy workflow

1. /claude-memory:resume — na start sesji.
2. Praca nad kodem (w razie potrzeby /claude-memory:graph).
3. /claude-memory:save [opcjonalny-slug] — na koniec sesji.

Pamięć w projekcie

Po pierwszym zapisie powstaje:

docs/claude-memory/
├── README.md          # zasady systemu pamięci
├── decisions.md       # trwałe decyzje („dlaczego tak”)
└── sessions/          # logi sesji (YYYY-MM-DD-opis.md)

W korzeniu projektu: graph.json — generowany lokalnie przez Python (stdlib) wbudowany w skill graph.

Szczegóły: docs/claude-memory/README.md.

Struktura tego repo

To repozytorium jest jednocześnie marketplace i źródłem pluginu:

.claude-plugin/marketplace.json   # katalog marketplace
plugins/claude-memory/
├── .claude-plugin/plugin.json    # manifest pluginu
└── skills/
    ├── resume/
    ├── save/                     # szablony pamięci w assets/
    └── graph/
        └── generate_graph.py     # generator graph.json (stdlib)

Skille używają ${CLAUDE_SKILL_DIR} — działają jako plugin, instalacja projektowa i globalna.

Wymagania

• Claude Code z obsługą pluginów i skilli
• Python 3 (tylko do generatora graph.json; biblioteka standardowa)

Licencja

Własność Xentivo sp. z o.o. — użycie wewnętrzne zespołu; szczegóły ustal z właścicielem repozytorium.