🌐 Aceasta este o traducere automată. Corecțiile din partea comunității sunt binevenite!

<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">Sistem persistent de compresie a memoriei construit pentru <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="#quick-start">Start Rapid</a> •
  <a href="#how-it-works">Cum Funcționează</a> •
  <a href="#mcp-search-tools">Instrumente de Căutare</a> •
  <a href="#documentation">Documentație</a> •
  <a href="#configuration">Configurare</a> •
  <a href="#troubleshooting">Depanare</a> •
  <a href="#license">Licență</a>
</p>

<p align="center">
  Claude-Mem păstrează contextul fără întrerupere între sesiuni prin capturarea automată a observațiilor de utilizare a instrumentelor, generarea de rezumate semantice și punerea lor la dispoziție în sesiunile viitoare. Aceasta permite lui Claude să mențină continuitatea cunoștințelor despre proiecte chiar și după încheierea sau reconectarea sesiunilor.
</p>

---

## Start Rapid

Instalați cu o singură comandă:

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

Sau instalați pentru OpenCode:

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

Sau instalați pentru Antigravity CLI ([ghid de configurare](https://docs.claude-mem.ai/antigravity-cli/setup)):

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

Sau instalați din marketplace-ul de plugin-uri direct din Claude Code:

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

/plugin install claude-mem
```

Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat în sesiunile noi.

> **Notă:** Claude-Mem este publicat și pe npm, dar `npm install -g claude-mem` instalează **doar SDK-ul/biblioteca** — nu înregistrează hook-urile plugin-ului și nu configurează serviciul worker. Instalați întotdeauna prin `npx claude-mem install` sau comenzile `/plugin` de mai sus.

### 🦞 OpenClaw Gateway

Instalați claude-mem ca plugin de memorie persistentă pe gateway-urile [OpenClaw](https://openclaw.ai) cu o singură comandă:

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

Programul de instalare gestionează dependențele, configurarea plugin-ului, configurarea furnizorului AI, pornirea worker-ului și fluxurile opționale de observații în timp real către Telegram, Discord, Slack și altele. Consultați [Ghidul de Integrare OpenClaw](https://docs.claude-mem.ai/openclaw-integration) pentru detalii.

**Caracteristici Principale:**

- 🧠 **Memorie Persistentă** - Contextul supraviețuiește între sesiuni
- 📊 **Dezvăluire Progresivă** - Recuperare stratificată a memoriei cu vizibilitate asupra costurilor în tokeni
- 🔍 **Căutare Bazată pe Abilități** - Interogați istoricul proiectului cu abilitatea mem-search
- 🖥️ **Interfață Web Viewer** - Flux de memorie în timp real la adresa URL a worker-ului afișată la pornire
- 💻 **Abilitate Claude Desktop** - Căutați în memorie din conversațiile Claude Desktop
- 🔒 **Control al Confidențialității** - Utilizați etichete `<private>` pentru a exclude conținutul sensibil de la stocare
- ⚙️ **Configurare Context** - Control fin asupra contextului care este injectat
- 🤖 **Operare Automată** - Nu necesită intervenție manuală
- 🔗 **Citări** - Referință la observații anterioare cu ID-uri prin API-ul worker-ului sau vizualizați-le pe toate în web viewer

---

## Documentație

📚 **[Vizualizați Documentația Completă](https://docs.claude-mem.ai/)** - Răsfoiți pe site-ul oficial

### Introducere

- **[Ghid de Instalare](https://docs.claude-mem.ai/installation)** - Start rapid și instalare avansată
- **[Ghid de Utilizare](https://docs.claude-mem.ai/usage/getting-started)** - Cum funcționează Claude-Mem automat
- **[Instrumente de Căutare](https://docs.claude-mem.ai/usage/search-tools)** - Interogați istoricul proiectului cu limbaj natural

### Practici Recomandate

- **[Inginerie de Context](https://docs.claude-mem.ai/context-engineering)** - Principii de optimizare a contextului pentru agenți AI
- **[Dezvăluire Progresivă](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofia din spatele strategiei de pregătire a contextului Claude-Mem

### Arhitectură

- **[Prezentare Generală](https://docs.claude-mem.ai/architecture/overview)** - Componente de sistem și flux de date
- **[Evoluția Arhitecturii](https://docs.claude-mem.ai/architecture-evolution)** - Parcursul de la v3 la v5
- **[Arhitectura Hook-urilor](https://docs.claude-mem.ai/hooks-architecture)** - Cum folosește Claude-Mem hook-urile de ciclu de viață
- **[Referință Hook-uri](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripturi de hook explicate
- **[Serviciu Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API și gestionare Bun
- **[Bază de Date](https://docs.claude-mem.ai/architecture/database)** - Schemă SQLite și căutare FTS5
- **[Arhitectura Căutării](https://docs.claude-mem.ai/architecture/search-architecture)** - Căutare hibridă cu baza de date vectorială Chroma

### Configurare și Dezvoltare

- **[Configurare](https://docs.claude-mem.ai/configuration)** - Variabile de mediu și setări
- **[Dezvoltare](https://docs.claude-mem.ai/development)** - Construire, testare, contribuție
- **[Ramuri de Lansare](https://docs.claude-mem.ai/branches)** - Fluxul ramurilor stable, core-dev și community-edge
- **[Depanare](https://docs.claude-mem.ai/troubleshooting)** - Probleme comune și soluții

---

## Cum Funcționează

**Componente Principale:**

1. **5 Hook-uri de Ciclu de Viață** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripturi de hook)
2. **Instalare Inteligentă** - Verificator de dependențe în cache (script pre-hook, nu un hook de ciclu de viață)
3. **Serviciu Worker** - HTTP API local cu interfață web viewer și endpoint-uri de căutare, gestionat de Bun
4. **Bază de Date SQLite** - Stochează sesiuni, observații, rezumate
5. **Abilitatea mem-search** - Interogări în limbaj natural cu dezvăluire progresivă
6. **Bază de Date Vectorială Chroma** - Căutare hibridă semantică + cuvinte cheie pentru recuperare inteligentă a contextului

Consultați [Prezentarea Generală a Arhitecturii](https://docs.claude-mem.ai/architecture/overview) pentru detalii.

---

## Instrumente de Căutare MCP

Claude-Mem oferă căutare inteligentă în memorie prin **4 instrumente MCP** care urmează un tipar de flux de lucru **eficient din punct de vedere al tokenilor, pe 3 niveluri**:

**Fluxul de Lucru pe 3 Niveluri:**

1. **`search`** - Obțineți un index compact cu ID-uri (~50-100 tokeni/rezultat)
2. **`timeline`** - Obțineți context cronologic în jurul rezultatelor interesante
3. **`get_observations`** - Preluați detalii complete DOAR pentru ID-urile filtrate (~500-1.000 tokeni/rezultat)

**Cum Funcționează:**
- Claude folosește instrumente MCP pentru a căuta în memoria dumneavoastră
- Începeți cu `search` pentru a obține un index de rezultate
- Folosiți `timeline` pentru a vedea ce se întâmpla în jurul unor observații specifice
- Folosiți `get_observations` pentru a prelua detalii complete pentru ID-urile relevante
- **Economii de aproximativ 10x în tokeni** prin filtrare înainte de preluarea detaliilor

**Instrumente MCP Disponibile:**

1. **`search`** - Căutați în indexul memoriei cu interogări full-text, filtrare după tip/dată/proiect
2. **`timeline`** - Obțineți context cronologic în jurul unei observații sau interogări specifice
3. **`get_observations`** - Preluați detalii complete ale observațiilor după ID-uri (grupați întotdeauna mai multe ID-uri)

**Exemplu de Utilizare:**

```typescript
// Pasul 1: Căutați pentru index
search(query="authentication bug", type="bugfix", limit=10)

// Pasul 2: Revizuiți indexul, identificați ID-urile relevante (de ex. #123, #456)

// Pasul 3: Preluați detaliile complete
get_observations(ids=[123, 456])
```

Consultați [Ghidul Instrumentelor de Căutare](https://docs.claude-mem.ai/usage/search-tools) pentru exemple detaliate.

---

## Ramuri de Lansare

Lansările stabile pornesc din `main` și sunt publicate pe npm. `core-dev` și
`community-edge` sunt ramuri rulate direct din sursă pentru remedieri timpurii de fiabilitate și
integrări comunitare. Consultați **[Ramuri de Lansare](https://docs.claude-mem.ai/branches)**
pentru fluxul ramurilor și instrucțiunile de rulare non-stabile.

---

## Cerințe de Sistem

- **Node.js**: 20.0.0 sau superior
- **Claude Code**: Versiunea cea mai recentă cu suport pentru plugin-uri
- **Bun**: Runtime JavaScript și manager de procese (instalat automat dacă lipsește)
- **uv**: Manager de pachete Python pentru căutare vectorială (instalat automat dacă lipsește)
- **SQLite 3**: Pentru stocare persistentă (inclus)

---
### Note de Configurare pentru Windows

Dacă vedeți o eroare de tipul:

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

Asigurați-vă că Node.js și npm sunt instalate și adăugate în PATH. Descărcați cel mai recent program de instalare Node.js de la https://nodejs.org și reporniți terminalul după instalare.

---

## Configurare

Setările sunt gestionate în `~/.claude-mem/settings.json` (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker-ului, directorul de date, nivelul de log și setările de injectare a contextului.

Consultați **[Ghidul de Configurare](https://docs.claude-mem.ai/configuration)** pentru toate setările disponibile și exemple.

### Configurarea Modului și Limbii

Claude-Mem suportă mai multe moduri de lucru și limbi prin setarea `CLAUDE_MEM_MODE`.

Această opțiune controlează:
- Comportamentul fluxului de lucru (de ex. code, chill, investigation)
- Limba folosită în observațiile generate

#### Cum se Configurează

Editați fișierul de setări la `~/.claude-mem/settings.json`:

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

Modurile sunt definite în `plugin/modes/`. Pentru a vedea toate modurile disponibile local:

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

#### Moduri Disponibile

| Mod | Descriere |
|------------|-------------------------|
| `code` | Mod implicit în engleză |
| `code--zh` | Mod în chineză simplificată |
| `code--ja` | Mod în japoneză |

Modurile specifice limbii urmează tiparul `code--[lang]`, unde `[lang]` este codul de limbă ISO 639-1 (de ex. `zh` pentru chineză, `ja` pentru japoneză, `es` pentru spaniolă).

> Notă: `code--zh` (chineză simplificată) este deja integrat — nu este necesară nicio instalare suplimentară sau actualizare a plugin-ului.

#### După Schimbarea Modului

Reporniți Claude Code pentru a aplica noua configurație a modului.
---

## Dezvoltare

Consultați **[Ghidul de Dezvoltare](https://docs.claude-mem.ai/development)** pentru instrucțiuni de construire, testare și fluxul de contribuție.

---

## Depanare

Dacă întâmpinați probleme, descrieți problema lui Claude, iar abilitatea troubleshoot va diagnostica automat și va furniza soluții.

Consultați **[Ghidul de Depanare](https://docs.claude-mem.ai/troubleshooting)** pentru probleme comune și soluții.

---

## Rapoarte de Erori

Creați rapoarte de erori complete cu generatorul automat:

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

## Contribuție

Contribuțiile sunt binevenite! Vă rugăm:

1. Faceți fork la repository
2. Creați o ramură de funcție
3. Faceți modificările cu teste
4. Actualizați documentația
5. Trimiteți un Pull Request

Claude-Mem este lansat din trei ramuri: `main` (stabilă), `core-dev` și
`community-edge`. Doar `main` este publicată pe npm; celelalte sunt rulate din
sursă. Consultați [Ramuri de Lansare](https://docs.claude-mem.ai/branches) pentru
strategie și instrucțiuni de rulare locală.

Consultați [Ghidul de Dezvoltare](https://docs.claude-mem.ai/development) pentru fluxul de contribuție.

---

## Licență

Claude-Mem este licențiat sub Apache License 2.0.

Am ales Apache-2.0 pentru că memoria agentică durabilă ar trebui să fie ușor de integrat în
instrumente pentru dezvoltatori, agenți locali, servere MCP, sisteme enterprise, stive de robotică
și medii de rulare agentice de producție.

Consultați fișierul [LICENSE](LICENSE) pentru detalii complete. Consultați [docs/license.md](docs/license.md)
și [docs/ip-boundary.md](docs/ip-boundary.md) pentru domeniul de aplicare al licenței și granița
open-source/comercială.

**Notă despre Ragtime**: Directorul `ragtime/` este licențiat sub **Apache License 2.0**. Consultați [ragtime/LICENSE](ragtime/LICENSE) pentru detalii.

---

## Suport

- **Documentație**: [docs/](docs/)
- **Probleme**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Cont Oficial X**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Discord Oficial**: [Alăturați-vă pe Discord](https://discord.com/invite/J4wttp9vDu)
- **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Construit cu Claude Agent SDK** | **Funcționează cu Claude Code** | **Realizat cu TypeScript**

---

### Ce Este cu CMEM?

CMEM este un token creat de o terță parte, dar îmbrățișat oficial de creatorul Claude-Mem (Alex Newman, @thedotmack). Token-ul acționează ca un catalizator comunitar pentru creștere și ca un vehicul pentru a aduce CMEM la dezvoltatorii și lucrătorii din domeniul cunoașterii care au cea mai mare nevoie de el.

CA Oficial BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3