Skip to content

Latest commit

 

History

History
431 lines (316 loc) · 17.4 KB

File metadata and controls

431 lines (316 loc) · 17.4 KB

🌐 Detta är en automatiserad översättning. Bidrag från gemenskapen är välkomna!

🇨🇳 中文🇹🇼 繁體中文🇯🇵 日本語🇵🇹 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 minneskomprimeringssystem byggt för Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

SnabbstartHur det fungerarSökverktygDokumentationKonfigurationFelsökningLicens

Claude-Mem bevarar sömlöst kontext mellan sessioner genom att automatiskt fånga observationer av verktygsanvändning, generera semantiska sammanfattningar och göra dem tillgängliga för framtida sessioner. Detta gör det möjligt för Claude att upprätthålla kontinuitet i kunskap om projekt även efter att sessioner avslutas eller återansluter.


Snabbstart

Installera med ett enda kommando:

npx claude-mem install

Eller installera för OpenCode:

npx claude-mem install --ide opencode

Eller installera för Antigravity CLI (installationsguide):

npx claude-mem install --ide antigravity

Eller installera från plugin-marknadsplatsen inuti Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Starta om Claude Code. Kontext från tidigare sessioner kommer automatiskt att visas i nya sessioner.

Obs: Claude-Mem publiceras även på npm, men npm install -g claude-mem installerar endast SDK:t/biblioteket — det registrerar inte plugin-krokarna och konfigurerar inte worker-tjänsten. Installera alltid via npx claude-mem install eller /plugin-kommandona ovan.

🦞 OpenClaw Gateway

Installera claude-mem som en persistent minnesplugin på OpenClaw-gateways med ett enda kommando:

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

Installationsprogrammet hanterar beroenden, plugin-konfiguration, konfiguration av AI-leverantör, uppstart av worker samt valfria realtidsobservationsflöden till Telegram, Discord, Slack med flera. Se OpenClaw-integrationsguiden för mer information.

Nyckelfunktioner:

  • 🧠 Persistent minne - Kontext överlever mellan sessioner
  • 📊 Progressiv visning - Skiktad minneshämtning med synlighet för tokenkostnad
  • 🔍 Färdighetsbaserad sökning - Fråga i din projekthistorik med mem-search-färdigheten
  • 🖥️ Webbvy-gränssnitt - Realtidsminnesström på worker-URL:en som skrivs ut vid start
  • 💻 Claude Desktop-färdighet - Sök i minnet från Claude Desktop-konversationer
  • 🔒 Integritetskontroll - Använd <private>-taggar för att exkludera känsligt innehåll från lagring
  • ⚙️ Kontextkonfiguration - Detaljerad kontroll över vilken kontext som injiceras
  • 🤖 Automatisk drift - Ingen manuell hantering krävs
  • 🔗 Citeringar - Referera till tidigare observationer med ID:n via worker-API:et eller visa alla i webbvyn

Dokumentation

📚 Visa fullständig dokumentation - Bläddra på den officiella webbplatsen

Komma igång

Bästa praxis

Arkitektur

Konfiguration och utveckling


Hur det fungerar

Kärnkomponenter:

  1. 5 livscykelkrokar - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-skript)
  2. Smart installation - Cachad beroendekontrollant (pre-hook-skript, inte en livscykelkrok)
  3. Worker Service - Lokalt HTTP API med webbvy-gränssnitt och sökändpunkter, hanterat av Bun
  4. SQLite-databas - Lagrar sessioner, observationer, sammanfattningar
  5. mem-search-färdighet - Naturligspråkssökningar med progressiv visning
  6. Chroma-vektordatabas - Hybrid semantisk + nyckelordssökning för intelligent kontexthämtning

Se Arkitekturöversikt för detaljer.


MCP-sökverktyg

Claude-Mem tillhandahåller intelligent minnessökning genom 4 MCP-verktyg som följer ett tokeneffektivt 3-lagers arbetsflödesmönster:

Arbetsflödet med 3 lager:

  1. search - Hämta ett kompakt index med ID:n (~50–100 tokens/resultat)
  2. timeline - Hämta kronologisk kontext kring intressanta resultat
  3. get_observations - Hämta fullständiga detaljer ENDAST för filtrerade ID:n (~500–1 000 tokens/resultat)

Så här fungerar det:

  • Claude använder MCP-verktyg för att söka i ditt minne
  • Börja med search för att få ett index över resultat
  • Använd timeline för att se vad som hände kring specifika observationer
  • Använd get_observations för att hämta fullständiga detaljer för relevanta ID:n
  • ~10x tokenbesparing genom att filtrera innan detaljer hämtas

Tillgängliga MCP-verktyg:

  1. search - Sök i minnesindexet med fritextfrågor, filtrera efter typ/datum/projekt
  2. timeline - Hämta kronologisk kontext kring en specifik observation eller fråga
  3. get_observations - Hämta fullständiga observationsdetaljer efter ID:n (batcha alltid flera ID:n)

Exempel på användning:

// Steg 1: Sök efter index
search(query="authentication bug", type="bugfix", limit=10)

// Steg 2: Granska indexet, identifiera relevanta ID:n (t.ex. #123, #456)

// Steg 3: Hämta fullständiga detaljer
get_observations(ids=[123, 456])

Se Sökverktygsguide för detaljerade exempel.


Release-grenar

Stabila utgåvor levereras från main och publiceras till npm. core-dev och community-edge är källkörda grenar för tidiga tillförlitlighetsfixar och community-integrationer. Se Release-grenar för grenflödet och instruktioner för att köra icke-stabila versioner.


Systemkrav

  • Node.js: 20.0.0 eller högre
  • Claude Code: Senaste versionen med plugin-stöd
  • Bun: JavaScript-runtime och processhanterare (installeras automatiskt om den saknas)
  • uv: Python-pakethanterare för vektorsökning (installeras automatiskt om den saknas)
  • SQLite 3: För persistent lagring (ingår)

Anteckningar för installation på Windows

Om du ser ett fel som:

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

Se till att Node.js och npm är installerade och tillagda i din PATH. Ladda ner den senaste Node.js-installationsfilen från https://nodejs.org och starta om terminalen efter installationen.


Konfiguration

Inställningar hanteras i ~/.claude-mem/settings.json (skapas automatiskt med standardvärden vid första körning). Konfigurera AI-modell, worker-port, datakatalog, loggnivå och inställningar för kontextinjektion.

Se Konfigurationsguide för alla tillgängliga inställningar och exempel.

Konfiguration av läge och språk

Claude-Mem stöder flera arbetsflödeslägen och språk via inställningen CLAUDE_MEM_MODE.

Detta alternativ styr både:

  • Arbetsflödesbeteendet (t.ex. code, chill, investigation)
  • Språket som används i genererade observationer

Så konfigurerar du det

Redigera din inställningsfil på ~/.claude-mem/settings.json:

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

Lägen definieras i plugin/modes/. För att se alla tillgängliga lägen lokalt:

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

Tillgängliga lägen

Läge Beskrivning
code Standardläge på engelska
code--zh Läge för förenklad kinesiska
code--ja Läge för japanska

Språkspecifika lägen följer mönstret code--[lang] där [lang] är ISO 639-1-språkkoden (t.ex. zh för kinesiska, ja för japanska, es för spanska).

Obs: code--zh (förenklad kinesiska) ingår redan inbyggt — ingen ytterligare installation eller plugin-uppdatering krävs.

Efter att du bytt läge

Starta om Claude Code för att tillämpa den nya lägeskonfigurationen.

Utveckling

Se Utvecklingsguide för bygginstruktioner, testning och bidragsarbetsflöde.


Felsökning

Om du upplever problem, beskriv problemet för Claude så kommer felsökningsfärdigheten automatiskt att diagnostisera och tillhandahålla lösningar.

Se Felsökningsguide för vanliga problem och lösningar.


Buggrapporter

Skapa omfattande buggrapporter med den automatiserade generatorn:

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

Bidrag

Bidrag är välkomna! Vänligen:

  1. Forka repositoryt
  2. Skapa en feature-gren
  3. Gör dina ändringar med tester
  4. Uppdatera dokumentationen
  5. Skicka in en Pull Request

Claude-Mem levereras från tre grenar: main (stabil), core-dev och community-edge. Endast main publiceras till npm; de andra körs från källkod. Se Release-grenar för strategin och instruktioner för lokal körning.

Se Utvecklingsguide för bidragsarbetsflöde.


Licens

Claude-Mem är licensierat under Apache License 2.0.

Vi valde Apache-2.0 eftersom hållbart agentiskt minne bör vara enkelt att bädda in i utvecklarverktyg, lokala agenter, MCP-servrar, företagssystem, robotikstackar och produktionsagenter.

Se filen LICENSE för fullständiga detaljer. Se docs/license.md och docs/ip-boundary.md för licensomfattning och gränsen mellan öppen och kommersiell användning.

Anmärkning om Ragtime: Katalogen ragtime/ är licensierad under Apache License 2.0. Se ragtime/LICENSE för detaljer.


Support


Byggd med Claude Agent SDK | Fungerar med Claude Code | Skapad med TypeScript


Vad är CMEM?

CMEM är en token skapad av tredje part men officiellt omfamnad av Claude-Mems skapare (Alex Newman, @thedotmack). Token fungerar som en katalysator för tillväxt inom gemenskapen och ett sätt att föra CMEM till de utvecklare och kunskapsarbetare som behöver det mest.

Officiell BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3