🌐 Toto je automatický překlad. Komunitní opravy jsou vítány!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Systém trvalé komprese paměti vytvořený pro Claude Code.
Rychlý start • Jak to funguje • Vyhledávací nástroje • Dokumentace • Konfigurace • Řešení problémů • Licence
Claude-Mem bezproblémově zachovává kontext napříč sezeními tím, že automaticky zaznamenává pozorování použití nástrojů, generuje sémantické souhrny a zpřístupňuje je budoucím sezením. To umožňuje Claude udržovat kontinuitu znalostí o projektech i po ukončení nebo opětovném připojení sezení.
Spusťte nové sezení Claude Code v terminálu a zadejte následující příkazy:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví v nových sezeních.
Klíčové vlastnosti:
- 🧠 Trvalá paměť - Kontext přetrvává napříč sezeními
- 📊 Postupné odhalování - Vrstvené vyhledávání paměti s viditelností nákladů na tokeny
- 🔍 Vyhledávání založené na dovednostech - Dotazujte se na historii projektu pomocí dovednosti mem-search
- 🖥️ Webové uživatelské rozhraní - Tok paměti v reálném čase na http://localhost:37777
- 💻 Dovednost pro Claude Desktop - Vyhledávejte v paměti z konverzací Claude Desktop
- 🔒 Kontrola soukromí - Použijte značky
<private>k vyloučení citlivého obsahu z úložiště - ⚙️ Konfigurace kontextu - Jemně odstupňovaná kontrola nad tím, jaký kontext se vkládá
- 🤖 Automatický provoz - Není vyžadován žádný manuální zásah
- 🔗 Citace - Odkazujte na minulá pozorování pomocí ID (přístup přes http://localhost:37777/api/observation/{id} nebo zobrazit vše ve webovém prohlížeči na http://localhost:37777)
- 🧪 Beta kanál - Vyzkoušejte experimentální funkce jako Endless Mode přepnutím verze
📚 Zobrazit kompletní dokumentaci - Procházet na oficiálních stránkách
- Průvodce instalací - Rychlý start a pokročilá instalace
- Průvodce použitím - Jak Claude-Mem funguje automaticky
- Vyhledávací nástroje - Dotazujte se na historii projektu pomocí přirozeného jazyka
- Beta funkce - Vyzkoušejte experimentální funkce jako Endless Mode
- Context Engineering - Principy optimalizace kontextu AI agenta
- Postupné odhalování - Filozofie strategie přípravy kontextu Claude-Mem
- Přehled - Systémové komponenty a tok dat
- Evoluce architektury - Cesta z v3 na v5
- Architektura háčků - Jak Claude-Mem používá lifecycle hooks
- Reference háčků - Vysvětlení 7 hook skriptů
- Worker Service - HTTP API a správa Bun
- Databáze - SQLite schéma a FTS5 vyhledávání
- Architektura vyhledávání - Hybridní vyhledávání s vektorovou databází Chroma
- Konfigurace - Proměnné prostředí a nastavení
- Vývoj - Sestavení, testování, přispívání
- Řešení problémů - Běžné problémy a řešení
Hlavní komponenty:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook skriptů)
- Chytrá instalace - Kontrola cachovaných závislostí (pre-hook skript, ne lifecycle hook)
- Worker Service - HTTP API na portu 37777 s webovým prohlížečem a 10 vyhledávacími endpointy, spravováno pomocí Bun
- SQLite databáze - Ukládá sezení, pozorování, souhrny
- mem-search dovednost - Dotazy v přirozeném jazyce s postupným odhalováním
- Chroma vektorová databáze - Hybridní sémantické + klíčové vyhledávání pro inteligentní vyhledávání kontextu
Podrobnosti najdete v Přehledu architektury.
Claude-Mem poskytuje inteligentní vyhledávání prostřednictvím dovednosti mem-search, která se automaticky vyvolá, když se ptáte na minulou práci:
Jak to funguje:
- Stačí se zeptat přirozeně: "Co jsme dělali minulé sezení?" nebo "Opravovali jsme tuto chybu dříve?"
- Claude automaticky vyvolá dovednost mem-search k nalezení relevantního kontextu
Dostupné vyhledávací operace:
- Search Observations - Fulltextové vyhledávání napříč pozorováními
- Search Sessions - Fulltextové vyhledávání napříč souhrny sezení
- Search Prompts - Vyhledávání surových požadavků uživatelů
- By Concept - Hledání podle koncepčních značek (discovery, problem-solution, pattern, atd.)
- By File - Hledání pozorování odkazujících na konkrétní soubory
- By Type - Hledání podle typu (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Získání nedávného kontextu sezení pro projekt
- Timeline - Získání jednotné časové osy kontextu kolem konkrétního bodu v čase
- Timeline by Query - Vyhledávání pozorování a získání kontextu časové osy kolem nejlepší shody
- API Help - Získání dokumentace k vyhledávacímu API
Příklady dotazů v přirozeném jazyce:
"Jaké chyby jsme opravili minulé sezení?" "Jak jsme implementovali autentizaci?" "Jaké změny byly provedeny v worker-service.ts?" "Ukaž mi nedávnou práci na tomto projektu" "Co se dělo, když jsme přidávali viewer UI?"
Podrobné příklady najdete v Průvodci vyhledávacími nástroji.
Claude-Mem nabízí beta kanál s experimentálními funkcemi jako Endless Mode (biomimetická architektura paměti pro prodloužená sezení). Přepínejte mezi stabilní a beta verzí z webového rozhraní na http://localhost:37777 → Settings.
Podrobnosti o Endless Mode a jak jej vyzkoušet najdete v Dokumentaci beta funkcí.
- Node.js: 18.0.0 nebo vyšší
- Claude Code: Nejnovější verze s podporou pluginů
- Bun: JavaScript runtime a správce procesů (automaticky nainstalován, pokud chybí)
- uv: Python správce balíčků pro vektorové vyhledávání (automaticky nainstalován, pokud chybí)
- SQLite 3: Pro trvalé úložiště (součástí balíčku)
Nastavení jsou spravována v ~/.claude-mem/settings.json (automaticky vytvořeno s výchozími hodnotami při prvním spuštění). Konfigurujte AI model, port workeru, datový adresář, úroveň logování a nastavení vkládání kontextu.
Všechna dostupná nastavení a příklady najdete v Průvodci konfigurací.
Podrobné pokyny k sestavení, testování a pracovnímu postupu pro přispívání najdete v Průvodci vývojem.
Pokud zaznamenáváte problémy, popište problém Claude a dovednost troubleshoot automaticky diagnostikuje a poskytne opravy.
Běžné problémy a řešení najdete v Průvodci řešením problémů.
Vytvořte komplexní hlášení chyby pomocí automatického generátoru:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Příspěvky jsou vítány! Prosím:
- Forkněte repositář
- Vytvořte feature branch
- Proveďte změny s testy
- Aktualizujte dokumentaci
- Odešlete Pull Request
Pracovní postup pro přispívání najdete v Průvodci vývojem.
Tento projekt je licencován pod GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Všechna práva vyhrazena.
Úplné podrobnosti najdete v souboru LICENSE.
Co to znamená:
- Software můžete volně používat, upravovat a distribuovat
- Pokud jej upravíte a nasadíte na síťovém serveru, musíte zpřístupnit svůj zdrojový kód
- Odvozená díla musí být také licencována pod AGPL-3.0
- Pro tento software neexistuje ŽÁDNÁ ZÁRUKA
Poznámka k Ragtime: Adresář ragtime/ je licencován samostatně pod PolyForm Noncommercial License 1.0.0. Podrobnosti najdete v ragtime/LICENSE.
- Dokumentace: docs/
- Problémy: GitHub Issues
- Repositář: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Vytvořeno pomocí Claude Agent SDK | Poháněno Claude Code | Vyrobeno s TypeScript
