Skip to content

README.nl.md

Latest commit

 

History

History
431 lines (316 loc) · 17.5 KB

README.nl.md

File metadata and controls

431 lines (316 loc) · 17.5 KB
Raw

🌐 Dit is een automatische vertaling. Gemeenschapscorrecties zijn welkom!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Persistent geheugencompressiesysteem gebouwd voor Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Snel Starten • Hoe Het Werkt • Zoektools • Documentatie • Configuratie • Probleemoplossing • Licentie

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.

Snel Starten

Installeer met één enkel commando:

npx claude-mem install

Of installeer voor OpenCode:

npx claude-mem install --ide opencode

Of installeer voor Antigravity CLI (installatiegids):

npx claude-mem install --ide antigravity

Of installeer vanuit de plugin marketplace binnen Claude Code:

/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 gateways met één enkel commando:

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 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 - Bladeren op de officiële website

Aan de Slag

Beste Praktijken

Architectuur

Configuratie & Ontwikkeling

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 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:

// 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 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 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:

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 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:

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

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

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 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 voor veelvoorkomende problemen en oplossingen.

Bugrapporten

Maak uitgebreide bugrapporten met de geautomatiseerde generator:

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 voor de strategie en instructies voor lokaal draaien.

Zie Ontwikkelingsgids 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 bestand voor volledige details. Zie docs/license.md en 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 voor details.

Ondersteuning

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