🌐 Dit is een automatische vertaling. Gemeenschapscorrecties zijn welkom!

<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">Persistent geheugencompressiesysteem gebouwd voor <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="#snel-starten">Snel Starten</a> •
  <a href="#hoe-het-werkt">Hoe Het Werkt</a> •
  <a href="#mcp-zoektools">Zoektools</a> •
  <a href="#documentatie">Documentatie</a> •
  <a href="#configuratie">Configuratie</a> •
  <a href="#probleemoplossing">Probleemoplossing</a> •
  <a href="#licentie">Licentie</a>
</p>

<p align="center">
  Claude-Mem behoudt naadloos context tussen sessies door automatisch waarnemingen van toolgebruik vast te leggen, semantische samenvattingen te genereren en deze beschikbaar te maken voor toekomstige sessies. Dit stelt Claude in staat om continuïteit van kennis over projecten te behouden, zelfs nadat sessies eindigen of opnieuw verbinden.
</p>

---

## Snel Starten

Installeer met één enkel commando:

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

Of installeer voor OpenCode:

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

Of installeer voor Antigravity CLI ([installatiegids](https://docs.claude-mem.ai/antigravity-cli/setup)):

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

Of installeer vanuit de plugin marketplace binnen Claude Code:

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

/plugin install claude-mem
```

Herstart Claude Code. Context van eerdere sessies verschijnt automatisch in nieuwe sessies.

> **Let op:** Claude-Mem wordt ook op npm gepubliceerd, maar `npm install -g claude-mem` installeert alleen de **SDK/bibliotheek** — het registreert de plugin hooks niet en zet de worker service niet op. Installeer altijd via `npx claude-mem install` of de bovenstaande `/plugin` commando's.

### 🦞 OpenClaw Gateway

Installeer claude-mem als een persistente geheugenplugin op [OpenClaw](https://openclaw.ai) gateways met één enkel commando:

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

Het installatieprogramma regelt afhankelijkheden, plugin-instellingen, AI-providerconfiguratie, worker-opstart en optionele real-time waarnemingsfeeds naar Telegram, Discord, Slack en meer. Zie de [OpenClaw Integratiegids](https://docs.claude-mem.ai/openclaw-integration) voor details.

**Belangrijkste Functies:**

- 🧠 **Persistent Geheugen** - Context blijft behouden tussen sessies
- 📊 **Progressieve Onthulling** - Gelaagde geheugenophaling met zichtbaarheid van tokenkosten
- 🔍 **Vaardigheidgebaseerd Zoeken** - Bevraag je projectgeschiedenis met de mem-search vaardigheid
- 🖥️ **Web Viewer UI** - Real-time geheugenstroom op de worker-URL die bij het opstarten wordt weergegeven
- 💻 **Claude Desktop Vaardigheid** - Zoek geheugen vanuit Claude Desktop gesprekken
- 🔒 **Privacycontrole** - Gebruik `<private>` tags om gevoelige content uit te sluiten van opslag
- ⚙️ **Context Configuratie** - Fijnmazige controle over welke context wordt geïnjecteerd
- 🤖 **Automatische Werking** - Geen handmatige tussenkomst vereist
- 🔗 **Citaten** - Verwijs naar eerdere waarnemingen met ID's via de worker API of bekijk alles in de web viewer

---

## Documentatie

📚 **[Bekijk Volledige Documentatie](https://docs.claude-mem.ai/)** - Bladeren op de officiële website

### Aan de Slag

- **[Installatiegids](https://docs.claude-mem.ai/installation)** - Snel starten & geavanceerde installatie
- **[Gebruikersgids](https://docs.claude-mem.ai/usage/getting-started)** - Hoe Claude-Mem automatisch werkt
- **[Zoektools](https://docs.claude-mem.ai/usage/search-tools)** - Bevraag je projectgeschiedenis met natuurlijke taal

### Beste Praktijken

- **[Context Engineering](https://docs.claude-mem.ai/context-engineering)** - AI agent context optimalisatieprincipes
- **[Progressieve Onthulling](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofie achter Claude-Mem's context priming strategie

### Architectuur

- **[Overzicht](https://docs.claude-mem.ai/architecture/overview)** - Systeemcomponenten & gegevensstroom
- **[Architectuurevolutie](https://docs.claude-mem.ai/architecture-evolution)** - De reis van v3 naar v5
- **[Hooks Architectuur](https://docs.claude-mem.ai/hooks-architecture)** - Hoe Claude-Mem lifecycle hooks gebruikt
- **[Hooks Referentie](https://docs.claude-mem.ai/architecture/hooks)** - 7 hook scripts uitgelegd
- **[Worker Service](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API & Bun beheer
- **[Database](https://docs.claude-mem.ai/architecture/database)** - SQLite schema & FTS5 zoeken
- **[Zoekarchitectuur](https://docs.claude-mem.ai/architecture/search-architecture)** - Hybride zoeken met Chroma vector database

### Configuratie & Ontwikkeling

- **[Configuratie](https://docs.claude-mem.ai/configuration)** - Omgevingsvariabelen & instellingen
- **[Ontwikkeling](https://docs.claude-mem.ai/development)** - Bouwen, testen, bijdragen
- **[Release Branches](https://docs.claude-mem.ai/branches)** - Stable, core-dev en community-edge branch-flow
- **[Probleemoplossing](https://docs.claude-mem.ai/troubleshooting)** - Veelvoorkomende problemen & oplossingen

---

## Hoe Het Werkt

**Kerncomponenten:**

1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
2. **Slimme Installatie** - Gecachte afhankelijkheidscontrole (pre-hook script, geen lifecycle hook)
3. **Worker Service** - Lokale HTTP API met web viewer UI en zoekendpoints, beheerd door Bun
4. **SQLite Database** - Slaat sessies, waarnemingen, samenvattingen op
5. **mem-search Vaardigheid** - Natuurlijke taal queries met progressieve onthulling
6. **Chroma Vector Database** - Hybride semantisch + zoekwoord zoeken voor intelligente context ophaling

Zie [Architectuuroverzicht](https://docs.claude-mem.ai/architecture/overview) voor details.

---

## MCP Zoektools

Claude-Mem biedt intelligent geheugenzoeken via **4 MCP-tools** volgens een tokenefficiënt **3-lagen workflowpatroon**:

**De 3-Lagen Workflow:**

1. **`search`** - Krijg een compacte index met ID's (~50-100 tokens/resultaat)
2. **`timeline`** - Krijg chronologische context rond interessante resultaten
3. **`get_observations`** - Haal volledige details op ALLEEN voor gefilterde ID's (~500-1.000 tokens/resultaat)

**Hoe Het Werkt:**
- Claude gebruikt MCP-tools om je geheugen te doorzoeken
- Begin met `search` om een index van resultaten te krijgen
- Gebruik `timeline` om te zien wat er gebeurde rond specifieke waarnemingen
- Gebruik `get_observations` om volledige details op te halen voor relevante ID's
- **~10x tokenbesparing** door te filteren vóórdat details worden opgehaald

**Beschikbare MCP-Tools:**

1. **`search`** - Doorzoek de geheugenindex met volledige-tekst queries, filter op type/datum/project
2. **`timeline`** - Krijg chronologische context rond een specifieke waarneming of query
3. **`get_observations`** - Haal volledige waarnemingsdetails op via ID's (bundel altijd meerdere ID's)

**Voorbeeldgebruik:**

```typescript
// Stap 1: Zoek naar index
search(query="authentication bug", type="bugfix", limit=10)

// Stap 2: Bekijk de index, identificeer relevante ID's (bijv. #123, #456)

// Stap 3: Haal volledige details op
get_observations(ids=[123, 456])
```

Zie [Zoektools Gids](https://docs.claude-mem.ai/usage/search-tools) voor gedetailleerde voorbeelden.

---

## Release Branches

Stabiele releases worden uitgebracht vanuit `main` en gepubliceerd op npm. `core-dev` en
`community-edge` zijn branches die vanuit de broncode draaien voor vroege betrouwbaarheidsfixes en
community-integraties. Zie **[Release Branches](https://docs.claude-mem.ai/branches)**
voor de branch-flow en instructies voor het draaien van niet-stabiele versies.

---

## Systeemvereisten

- **Node.js**: 20.0.0 of hoger
- **Claude Code**: Nieuwste versie met plugin ondersteuning
- **Bun**: JavaScript runtime en procesbeheer (automatisch geïnstalleerd indien ontbreekt)
- **uv**: Python package manager voor vector zoeken (automatisch geïnstalleerd indien ontbreekt)
- **SQLite 3**: Voor persistente opslag (meegeleverd)

---
### Opmerkingen bij Windows-installatie

Als je een fout ziet zoals:

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

Zorg ervoor dat Node.js en npm zijn geïnstalleerd en toegevoegd aan je PATH. Download het nieuwste Node.js-installatieprogramma van https://nodejs.org en herstart je terminal na installatie.

---

## Configuratie

Instellingen worden beheerd in `~/.claude-mem/settings.json` (automatisch aangemaakt met standaardinstellingen bij eerste run). Configureer AI-model, worker-poort, datamap, logniveau en context-injectie-instellingen.

Zie de **[Configuratiegids](https://docs.claude-mem.ai/configuration)** voor alle beschikbare instellingen en voorbeelden.

### Modus- & Taalconfiguratie

Claude-Mem ondersteunt meerdere workflowmodi en talen via de `CLAUDE_MEM_MODE` instelling.

Deze optie regelt zowel:
- Het workflowgedrag (bijv. code, chill, investigation)
- De taal die wordt gebruikt in gegenereerde waarnemingen

#### Hoe te Configureren

Bewerk je instellingenbestand op `~/.claude-mem/settings.json`:

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

Modi zijn gedefinieerd in `plugin/modes/`. Om alle lokaal beschikbare modi te zien:

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

#### Beschikbare Modi

| Modus | Beschrijving |
|------------|-------------------------|
| `code` | Standaard Engelse modus |
| `code--zh` | Vereenvoudigd Chinese modus |
| `code--ja` | Japanse modus |

Taalspecifieke modi volgen het patroon `code--[lang]` waarbij `[lang]` de ISO 639-1 taalcode is (bijv. `zh` voor Chinees, `ja` voor Japans, `es` voor Spaans).

> Let op: `code--zh` (Vereenvoudigd Chinees) is al ingebouwd — geen extra installatie of plugin-update is vereist.

#### Na het Wijzigen van de Modus

Herstart Claude Code om de nieuwe modusconfiguratie toe te passen.
---

## Ontwikkeling

Zie de **[Ontwikkelingsgids](https://docs.claude-mem.ai/development)** voor bouwinstructies, testen en bijdrageworkflow.

---

## Probleemoplossing

Als je problemen ervaart, beschrijf het probleem aan Claude en de troubleshoot vaardigheid zal automatisch diagnosticeren en oplossingen bieden.

Zie de **[Probleemoplossingsgids](https://docs.claude-mem.ai/troubleshooting)** voor veelvoorkomende problemen en oplossingen.

---

## Bugrapporten

Maak uitgebreide bugrapporten met de geautomatiseerde generator:

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

## Bijdragen

Bijdragen zijn welkom! Gelieve:

1. Fork de repository
2. Maak een feature branch
3. Maak je wijzigingen met tests
4. Update documentatie
5. Dien een Pull Request in

Claude-Mem wordt uitgebracht vanuit drie branches: `main` (stable), `core-dev`, en
`community-edge`. Alleen `main` wordt gepubliceerd op npm; de andere draaien vanuit
de broncode. Zie [Release Branches](https://docs.claude-mem.ai/branches) voor de
strategie en instructies voor lokaal draaien.

Zie [Ontwikkelingsgids](https://docs.claude-mem.ai/development) voor bijdrageworkflow.

---

## Licentie

Claude-Mem wordt uitgebracht onder de Apache License 2.0.

We hebben voor Apache-2.0 gekozen omdat duurzaam agentic geheugen eenvoudig ingebed
moet kunnen worden in ontwikkelaarstools, lokale agents, MCP-servers, enterprise-systemen,
robotica-stacks en productie-agentharnassen.

Zie het [LICENSE](LICENSE) bestand voor volledige details. Zie [docs/license.md](docs/license.md)
en [docs/ip-boundary.md](docs/ip-boundary.md) voor de licentiescope en de
grens tussen open en commercieel gebruik.

**Opmerking over Ragtime**: De `ragtime/` map is gelicenseerd onder de **Apache License 2.0**. Zie [ragtime/LICENSE](ragtime/LICENSE) voor details.

---

## Ondersteuning

- **Documentatie**: [docs/](docs/)
- **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Officieel X-account**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Officiële Discord**: [Word lid van Discord](https://discord.com/invite/J4wttp9vDu)
- **Auteur**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Gebouwd met Claude Agent SDK** | **Werkt met Claude Code** | **Gemaakt met TypeScript**

---

### Hoe Zit Het met CMEM?

CMEM is een token gecreëerd door een derde partij, maar officieel omarmd door de maker van Claude-Mem (Alex Newman, @thedotmack). Het token fungeert als een katalysator voor de community voor groei en een middel om CMEM te brengen naar de ontwikkelaars en kenniswerkers die het het hardst nodig hebben.

Officieel BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3