🌐 To jest automatyczne tłumaczenie. Korekty społeczności są mile widziane!

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">System trwałej kompresji pamięci stworzony dla <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#szybki-start">Szybki Start</a> •
  <a href="#jak-to-działa">Jak To Działa</a> •
  <a href="#narzędzia-wyszukiwania-mcp">Narzędzia Wyszukiwania</a> •
  <a href="#dokumentacja">Dokumentacja</a> •
  <a href="#konfiguracja">Konfiguracja</a> •
  <a href="#rozwiązywanie-problemów">Rozwiązywanie Problemów</a> •
  <a href="#licencja">Licencja</a>
</p>

<p align="center">
  Claude-Mem płynnie zachowuje kontekst między sesjami, automatycznie przechwytując obserwacje użycia narzędzi, generując semantyczne podsumowania i udostępniając je przyszłym sesjom. Dzięki temu Claude może utrzymać ciągłość wiedzy o projektach nawet po zakończeniu sesji lub ponownym połączeniu.
</p>

---

## Szybki Start

Zainstaluj za pomocą jednego polecenia:

```bash
npx claude-mem install
```

Lub zainstaluj dla OpenCode:

```bash
npx claude-mem install --ide opencode
```

Lub zainstaluj dla Antigravity CLI ([przewodnik konfiguracji](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

Lub zainstaluj z marketplace wtyczek wewnątrz Claude Code:

```bash
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
```

Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi się w nowych sesjach.

> **Uwaga:** Claude-Mem jest również opublikowany na npm, ale `npm install -g claude-mem` instaluje **wyłącznie SDK/bibliotekę** — nie rejestruje hooków wtyczki ani nie konfiguruje usługi worker. Zawsze instaluj za pomocą `npx claude-mem install` lub powyższych poleceń `/plugin`.

### 🦞 OpenClaw Gateway

Zainstaluj claude-mem jako wtyczkę trwałej pamięci na bramkach [OpenClaw](https://openclaw.ai) za pomocą jednego polecenia:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

Instalator obsługuje zależności, konfigurację wtyczki, konfigurację dostawcy AI, uruchomienie workera oraz opcjonalne strumienie obserwacji w czasie rzeczywistym do Telegram, Discord, Slack i innych. Zobacz [Przewodnik Integracji OpenClaw](https://docs.claude-mem.ai/openclaw-integration), aby poznać szczegóły.

**Kluczowe Funkcje:**

- 🧠 **Trwała Pamięć** - Kontekst przetrwa między sesjami
- 📊 **Stopniowe Ujawnianie** - Warstwowe pobieranie pamięci z widocznością kosztów tokenów
- 🔍 **Wyszukiwanie Oparte na Umiejętnościach** - Przeszukuj historię projektu za pomocą umiejętności mem-search
- 🖥️ **Interfejs Przeglądarki Internetowej** - Strumień pamięci w czasie rzeczywistym pod adresem URL workera wyświetlonym przy uruchomieniu
- 💻 **Umiejętność Claude Desktop** - Przeszukuj pamięć z konwersacji Claude Desktop
- 🔒 **Kontrola Prywatności** - Użyj tagów `<private>`, aby wykluczyć wrażliwe treści z przechowywania
- ⚙️ **Konfiguracja Kontekstu** - Szczegółowa kontrola nad tym, jaki kontekst jest wstrzykiwany
- 🤖 **Automatyczne Działanie** - Nie wymaga ręcznej interwencji
- 🔗 **Cytowania** - Odniesienia do przeszłych obserwacji za pomocą identyfikatorów przez API workera lub wyświetl wszystkie w przeglądarce internetowej

---

## Dokumentacja

📚 **[Wyświetl Pełną Dokumentację](https://docs.claude-mem.ai/)** - Przeglądaj na oficjalnej stronie

### Pierwsze Kroki

- **[Przewodnik Instalacji](https://docs.claude-mem.ai/installation)** - Szybki start i zaawansowana instalacja
- **[Przewodnik Użytkowania](https://docs.claude-mem.ai/usage/getting-started)** - Jak Claude-Mem działa automatycznie
- **[Narzędzia Wyszukiwania](https://docs.claude-mem.ai/usage/search-tools)** - Przeszukuj historię projektu w języku naturalnym

### Najlepsze Praktyki

- **[Inżynieria Kontekstu](https://docs.claude-mem.ai/context-engineering)** - Zasady optymalizacji kontekstu agenta AI
- **[Stopniowe Ujawnianie](https://docs.claude-mem.ai/progressive-disclosure)** - Filozofia strategii przygotowania kontekstu Claude-Mem

### Architektura

- **[Przegląd](https://docs.claude-mem.ai/architecture/overview)** - Komponenty systemu i przepływ danych
- **[Ewolucja Architektury](https://docs.claude-mem.ai/architecture-evolution)** - Droga od v3 do v5
- **[Architektura Hooków](https://docs.claude-mem.ai/hooks-architecture)** - Jak Claude-Mem wykorzystuje hooki cyklu życia
- **[Dokumentacja Hooków](https://docs.claude-mem.ai/architecture/hooks)** - 7 skryptów hooków wyjaśnionych
- **[Usługa Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API i zarządzanie Bun
- **[Baza Danych](https://docs.claude-mem.ai/architecture/database)** - Schemat SQLite i wyszukiwanie FTS5
- **[Architektura Wyszukiwania](https://docs.claude-mem.ai/architecture/search-architecture)** - Hybrydowe wyszukiwanie z bazą wektorów Chroma

### Konfiguracja i Rozwój

- **[Konfiguracja](https://docs.claude-mem.ai/configuration)** - Zmienne środowiskowe i ustawienia
- **[Rozwój](https://docs.claude-mem.ai/development)** - Budowanie, testowanie, współpraca
- **[Gałęzie Wydań](https://docs.claude-mem.ai/branches)** - Przepływ gałęzi stable, core-dev i community-edge
- **[Rozwiązywanie Problemów](https://docs.claude-mem.ai/troubleshooting)** - Typowe problemy i rozwiązania

---

## Jak To Działa

**Główne Komponenty:**

1. **5 Hooków Cyklu Życia** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skryptów hooków)
2. **Inteligentna Instalacja** - Buforowany sprawdzacz zależności (skrypt pre-hook, nie hook cyklu życia)
3. **Usługa Worker** - Lokalne HTTP API z interfejsem przeglądarki internetowej i punktami końcowymi wyszukiwania, zarządzane przez Bun
4. **Baza Danych SQLite** - Przechowuje sesje, obserwacje, podsumowania
5. **Umiejętność mem-search** - Zapytania w języku naturalnym ze stopniowym ujawnianiem
6. **Baza Wektorów Chroma** - Hybrydowe wyszukiwanie semantyczne + słowa kluczowe dla inteligentnego pobierania kontekstu

Zobacz [Przegląd Architektury](https://docs.claude-mem.ai/architecture/overview), aby poznać szczegóły.

---

## Narzędzia Wyszukiwania MCP

Claude-Mem zapewnia inteligentne wyszukiwanie pamięci poprzez **4 narzędzia MCP** zgodnie z efektywnym pod względem tokenów wzorcem **3-warstwowego przepływu pracy**:

**3-Warstwowy Przepływ Pracy:**

1. **`search`** - Uzyskaj kompaktowy indeks z identyfikatorami (~50-100 tokenów/wynik)
2. **`timeline`** - Uzyskaj chronologiczny kontekst wokół interesujących wyników
3. **`get_observations`** - Pobierz pełne szczegóły TYLKO dla przefiltrowanych identyfikatorów (~500-1 000 tokenów/wynik)

**Jak To Działa:**
- Claude używa narzędzi MCP do przeszukiwania Twojej pamięci
- Zacznij od `search`, aby uzyskać indeks wyników
- Użyj `timeline`, aby zobaczyć, co działo się wokół konkretnych obserwacji
- Użyj `get_observations`, aby pobrać pełne szczegóły dla odpowiednich identyfikatorów
- **Oszczędność tokenów ~10x** dzięki filtrowaniu przed pobraniem szczegółów

**Dostępne Narzędzia MCP:**

1. **`search`** - Przeszukuj indeks pamięci za pomocą zapytań pełnotekstowych, filtruj według typu/daty/projektu
2. **`timeline`** - Uzyskaj chronologiczny kontekst wokół konkretnej obserwacji lub zapytania
3. **`get_observations`** - Pobierz pełne szczegóły obserwacji według identyfikatorów (zawsze grupuj wiele identyfikatorów)

**Przykładowe Użycie:**

```typescript
// Krok 1: Wyszukaj indeks
search(query="authentication bug", type="bugfix", limit=10)

// Krok 2: Przejrzyj indeks, zidentyfikuj odpowiednie identyfikatory (np. #123, #456)

// Krok 3: Pobierz pełne szczegóły
get_observations(ids=[123, 456])
```

Zobacz [Przewodnik Narzędzi Wyszukiwania](https://docs.claude-mem.ai/usage/search-tools), aby poznać szczegółowe przykłady.

---

## Gałęzie Wydań

Stabilne wydania są publikowane z gałęzi `main` i trafiają do npm. `core-dev` i
`community-edge` to gałęzie uruchamiane ze źródła, przeznaczone do wczesnych poprawek
niezawodności i integracji społeczności. Zobacz **[Gałęzie Wydań](https://docs.claude-mem.ai/branches)**,
aby poznać przepływ gałęzi i instrukcje uruchamiania wersji niestabilnych.

---

## Wymagania Systemowe

- **Node.js**: 20.0.0 lub wyższy
- **Claude Code**: Najnowsza wersja z obsługą wtyczek
- **Bun**: Środowisko uruchomieniowe JavaScript i menedżer procesów (automatycznie instalowany, jeśli brakuje)
- **uv**: Menedżer pakietów Python do wyszukiwania wektorowego (automatycznie instalowany, jeśli brakuje)
- **SQLite 3**: Do trwałego przechowywania (dołączony)

---
### Uwagi Dotyczące Konfiguracji na Windows

Jeśli widzisz błąd podobny do:

```powershell
npm : The term 'npm' is not recognized as the name of a cmdlet
```

Upewnij się, że Node.js i npm są zainstalowane i dodane do zmiennej PATH. Pobierz najnowszy instalator Node.js ze strony https://nodejs.org i uruchom ponownie terminal po instalacji.

---

## Konfiguracja

Ustawienia są zarządzane w `~/.claude-mem/settings.json` (automatycznie tworzone z domyślnymi wartościami przy pierwszym uruchomieniu). Skonfiguruj model AI, port workera, katalog danych, poziom logowania i ustawienia wstrzykiwania kontekstu.

Zobacz **[Przewodnik Konfiguracji](https://docs.claude-mem.ai/configuration)**, aby poznać wszystkie dostępne ustawienia i przykłady.

### Konfiguracja Trybu i Języka

Claude-Mem obsługuje wiele trybów pracy i języków poprzez ustawienie `CLAUDE_MEM_MODE`.

Ta opcja kontroluje jednocześnie:
- Zachowanie przepływu pracy (np. code, chill, investigation)
- Język używany w generowanych obserwacjach

#### Jak Skonfigurować

Edytuj plik ustawień w `~/.claude-mem/settings.json`:

```json
{
  "CLAUDE_MEM_MODE": "code--zh"
}
```

Tryby są zdefiniowane w `plugin/modes/`. Aby zobaczyć wszystkie dostępne tryby lokalnie:

```bash
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
```

#### Dostępne Tryby

| Tryb | Opis |
|------------|-------------------------|
| `code` | Domyślny tryb angielski |
| `code--zh` | Tryb uproszczonego chińskiego |
| `code--ja` | Tryb japoński |

Tryby specyficzne dla języka podążają za wzorcem `code--[lang]`, gdzie `[lang]` to kod języka ISO 639-1 (np. `zh` dla chińskiego, `ja` dla japońskiego, `es` dla hiszpańskiego).

> Uwaga: `code--zh` (uproszczony chiński) jest już wbudowany — nie jest wymagana dodatkowa instalacja ani aktualizacja wtyczki.

#### Po Zmianie Trybu

Uruchom ponownie Claude Code, aby zastosować nową konfigurację trybu.
---

## Rozwój

Zobacz **[Przewodnik Rozwoju](https://docs.claude-mem.ai/development)**, aby poznać instrukcje budowania, testowania i przepływu pracy współpracy.

---

## Rozwiązywanie Problemów

Jeśli napotkasz problemy, opisz problem Claude, a umiejętność troubleshoot automatycznie zdiagnozuje i dostarczy poprawki.

Zobacz **[Przewodnik Rozwiązywania Problemów](https://docs.claude-mem.ai/troubleshooting)** dla typowych problemów i rozwiązań.

---

## Zgłoszenia Błędów

Twórz kompleksowe raporty błędów za pomocą automatycznego generatora:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
```

## Współpraca

Wkład jest mile widziany! Proszę:

1. Forkuj repozytorium
2. Utwórz gałąź funkcji
3. Dokonaj zmian z testami
4. Zaktualizuj dokumentację
5. Prześlij Pull Request

Claude-Mem jest wydawany z trzech gałęzi: `main` (stabilna), `core-dev` oraz
`community-edge`. Tylko `main` jest publikowana na npm; pozostałe są uruchamiane
ze źródła. Zobacz [Gałęzie Wydań](https://docs.claude-mem.ai/branches), aby poznać
strategię i instrukcje lokalnego uruchamiania.

Zobacz [Przewodnik Rozwoju](https://docs.claude-mem.ai/development) dla przepływu pracy współpracy.

---

## Licencja

Claude-Mem jest licencjonowany na podstawie Apache License 2.0.

Wybraliśmy Apache-2.0, ponieważ trwała pamięć agentowa powinna być łatwa do
osadzenia w narzędziach deweloperskich, lokalnych agentach, serwerach MCP,
systemach korporacyjnych, stosach robotyki i produkcyjnych środowiskach agentów.

Zobacz plik [LICENSE](LICENSE), aby poznać pełne szczegóły. Zobacz [docs/license.md](docs/license.md)
oraz [docs/ip-boundary.md](docs/ip-boundary.md), aby poznać zakres licencjonowania i
granicę między wersją otwartą a komercyjną.

**Uwaga dotycząca Ragtime**: Katalog `ragtime/` jest licencjonowany na podstawie **Apache License 2.0**. Zobacz [ragtime/LICENSE](ragtime/LICENSE), aby poznać szczegóły.

---

## Wsparcie

- **Dokumentacja**: [docs/](docs/)
- **Problemy**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repozytorium**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Oficjalne Konto X**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Oficjalny Discord**: [Dołącz do Discord](https://discord.com/invite/J4wttp9vDu)
- **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Zbudowano za pomocą Claude Agent SDK** | **Działa z Claude Code** | **Wykonane w TypeScript**

---

### A Co z CMEM?

CMEM to token stworzony przez stronę trzecią, ale oficjalnie zaakceptowany przez twórcę Claude-Mem (Alex Newman, @thedotmack). Token pełni rolę katalizatora rozwoju społeczności i wehikułu wprowadzającego CMEM do deweloperów i pracowników wiedzy, którzy najbardziej go potrzebują.

Oficjalny adres kontraktu BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3