Skip to content

Latest commit

 

History

History
431 lines (316 loc) · 17.3 KB

File metadata and controls

431 lines (316 loc) · 17.3 KB

🌐 Dette er en automatisk oversættelse. Fællesskabsrettelser er velkomne!

🇨🇳 中文🇹🇼 繁體中文🇯🇵 日本語🇵🇹 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

Vedvarende hukommelseskomprimeringssystem bygget til Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Hurtig StartSådan Virker DetSøgeværktøjerDokumentationKonfigurationFejlfindingLicens

Claude-Mem bevarer problemfrit kontekst på tværs af sessioner ved automatisk at fange observationer af værktøjsbrug, generere semantiske resuméer og gøre dem tilgængelige for fremtidige sessioner. Dette gør det muligt for Claude at opretholde kontinuitet i viden om projekter, selv efter sessioner afsluttes eller genopretter forbindelse.


Hurtig Start

Installer med en enkelt kommando:

npx claude-mem install

Eller installer til OpenCode:

npx claude-mem install --ide opencode

Eller installer til Antigravity CLI (opsætningsguide):

npx claude-mem install --ide antigravity

Eller installer fra plugin-markedspladsen inde i Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Genstart Claude Code. Kontekst fra tidligere sessioner vil automatisk vises i nye sessioner.

Bemærk: Claude-Mem er også udgivet på npm, men npm install -g claude-mem installerer kun SDK'et/biblioteket — det registrerer ikke plugin-hooks eller opsætter worker-servicen. Installer altid via npx claude-mem install eller /plugin-kommandoerne ovenfor.

🦞 OpenClaw Gateway

Installer claude-mem som et vedvarende hukommelsesplugin på OpenClaw-gateways med en enkelt kommando:

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

Installationsprogrammet håndterer afhængigheder, plugin-opsætning, konfiguration af AI-udbyder, worker-opstart og valgfrie realtidsobservationsfeeds til Telegram, Discord, Slack og mere. Se OpenClaw-integrationsguiden for detaljer.

Nøglefunktioner:

  • 🧠 Vedvarende Hukommelse - Kontekst overlever på tværs af sessioner
  • 📊 Progressiv Afsløring - Lagdelt hukommelseshentning med synlighed af token-omkostninger
  • 🔍 Færdighedsbaseret Søgning - Forespørg din projekthistorik med mem-search-færdighed
  • 🖥️ Web Viewer UI - Realtids hukommelsesstream på den worker-URL, der udskrives ved opstart
  • 💻 Claude Desktop-færdighed - Søg i hukommelsen fra Claude Desktop-samtaler
  • 🔒 Privatkontrol - Brug <private>-tags til at ekskludere følsomt indhold fra lagring
  • ⚙️ Kontekstkonfiguration - Finjusteret kontrol over hvilken kontekst der indsprøjtes
  • 🤖 Automatisk Drift - Ingen manuel indgriben påkrævet
  • 🔗 Citationer - Henvis til tidligere observationer med ID'er via worker-API'et eller se dem alle i web viewer

Dokumentation

📚 Se Fuld Dokumentation - Gennemse på den officielle hjemmeside

Kom Godt I Gang

Bedste Praksis

Arkitektur

Konfiguration & Udvikling


Sådan Virker Det

Kernekomponenter:

  1. 5 Livscyklus-hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-scripts)
  2. Smart Installation - Cached dependency checker (pre-hook-script, ikke en livscyklus-hook)
  3. Worker Service - Lokalt HTTP API med web viewer UI og søge-endpoints, administreret af Bun
  4. SQLite Database - Gemmer sessioner, observationer, resuméer
  5. mem-search-færdighed - Naturlige sprogforespørgsler med progressiv afsløring
  6. Chroma Vector Database - Hybrid semantisk + søgeordssøgning for intelligent konteksthentning

Se Arkitekturoversigt for detaljer.


MCP Søgeværktøjer

Claude-Mem leverer intelligent hukommelsessøgning gennem 4 MCP-værktøjer, der følger et token-effektivt 3-lags workflowmønster:

De 3 Workflowlag:

  1. search - Få et kompakt indeks med ID'er (~50-100 tokens/resultat)
  2. timeline - Få kronologisk kontekst omkring interessante resultater
  3. get_observations - Hent fulde detaljer KUN for filtrerede ID'er (~500-1.000 tokens/resultat)

Sådan Virker Det:

  • Claude bruger MCP-værktøjer til at søge i din hukommelse
  • Start med search for at få et indeks over resultater
  • Brug timeline til at se, hvad der skete omkring specifikke observationer
  • Brug get_observations til at hente fulde detaljer for relevante ID'er
  • ~10x besparelse i tokens ved at filtrere før detaljer hentes

Tilgængelige MCP-værktøjer:

  1. search - Søg i hukommelsesindekset med fuldtekstforespørgsler, filtrer efter type/dato/projekt
  2. timeline - Få kronologisk kontekst omkring en specifik observation eller forespørgsel
  3. get_observations - Hent fulde observationsdetaljer efter ID'er (batch altid flere ID'er sammen)

Eksempel på Brug:

// Trin 1: Søg efter indeks
search(query="authentication bug", type="bugfix", limit=10)

// Trin 2: Gennemgå indekset, identificer relevante ID'er (f.eks. #123, #456)

// Trin 3: Hent fulde detaljer
get_observations(ids=[123, 456])

Se Søgeværktøjsguide for detaljerede eksempler.


Release-grene

Stable releases udsendes fra main og publiceres til npm. core-dev og community-edge er kildekørte grene til tidlige pålidelighedsrettelser og community-integrationer. Se Release-grene for grenflowet og instruktioner til kørsel af ikke-stabile versioner.


Systemkrav

  • Node.js: 20.0.0 eller højere
  • Claude Code: Seneste version med plugin-support
  • Bun: JavaScript runtime og procesmanager (auto-installeres, hvis manglende)
  • uv: Python package manager til vektorsøgning (auto-installeres, hvis manglende)
  • SQLite 3: Til vedvarende lagring (bundtet)

Windows-opsætningsnoter

Hvis du ser en fejl som:

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

Sørg for, at Node.js og npm er installeret og tilføjet til din PATH. Download den nyeste Node.js-installer fra https://nodejs.org og genstart din terminal efter installationen.


Konfiguration

Indstillinger administreres i ~/.claude-mem/settings.json (auto-oprettet med standardindstillinger ved første kørsel). Konfigurer AI-model, worker-port, datakatalog, log-niveau og indstillinger for kontekstindsprøjtning.

Se Konfigurationsguide for alle tilgængelige indstillinger og eksempler.

Tilstands- & Sprogkonfiguration

Claude-Mem understøtter flere workflow-tilstande og sprog via indstillingen CLAUDE_MEM_MODE.

Denne indstilling styrer både:

  • Workflow-adfærden (f.eks. code, chill, investigation)
  • Sproget, der bruges i genererede observationer

Sådan Konfigurerer Du

Rediger din indstillingsfil på ~/.claude-mem/settings.json:

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

Tilstande er defineret i plugin/modes/. For at se alle tilgængelige tilstande lokalt:

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

Tilgængelige Tilstande

Tilstand Beskrivelse
code Standard engelsk tilstand
code--zh Forenklet kinesisk tilstand
code--ja Japansk tilstand

Sprogspecifikke tilstande følger mønsteret code--[lang], hvor [lang] er ISO 639-1-sprogkoden (f.eks. zh for kinesisk, ja for japansk, es for spansk).

Bemærk: code--zh (forenklet kinesisk) er allerede indbygget — der kræves ingen yderligere installation eller plugin-opdatering.

Efter Ændring af Tilstand

Genstart Claude Code for at anvende den nye tilstandskonfiguration.

Udvikling

Se Udviklingsguide for bygningsinstruktioner, testning og bidragsworkflow.


Fejlfinding

Hvis du oplever problemer, beskriv problemet til Claude, og troubleshoot-færdigheden vil automatisk diagnosticere og levere rettelser.

Se Fejlfindingsguide for almindelige problemer og løsninger.


Fejlrapporter

Opret omfattende fejlrapporter med den automatiserede generator:

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

Bidrag

Bidrag er velkomne! Venligst:

  1. Fork repositoriet
  2. Opret en feature-branch
  3. Lav dine ændringer med tests
  4. Opdater dokumentation
  5. Indsend en Pull Request

Claude-Mem udsendes fra tre grene: main (stable), core-dev og community-edge. Kun main publiceres til npm; de andre køres fra kildekode. Se Release-grene for strategien og instruktioner til lokal kørsel.

Se Udviklingsguide for bidragsworkflow.


Licens

Claude-Mem er licenseret under Apache License 2.0.

Vi valgte Apache-2.0, fordi holdbar agentisk hukommelse bør være nem at indlejre i udviklerværktøjer, lokale agenter, MCP-servere, virksomhedssystemer, robotik-stacks og produktionsagent-harnesser.

Se filen LICENSE for fulde detaljer. Se docs/license.md og docs/ip-boundary.md for licensomfang og grænsen mellem open source og kommercielt.

Bemærkning om Ragtime: Mappen ragtime/ er licenseret under Apache License 2.0. Se ragtime/LICENSE for detaljer.


Support


Bygget med Claude Agent SDK | Fungerer med Claude Code | Lavet med TypeScript


Hvad Med CMEM?

CMEM er en token skabt af en tredjepart, men officielt anerkendt af skaberen af Claude-Mem (Alex Newman, @thedotmack). Tokenet fungerer som en katalysator for fællesskabsvækst og et redskab til at bringe CMEM til de udviklere og videnarbejdere, der har mest brug for det.

Officiel BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3