🌐 זהו תרגום אוטומטי. תיקונים מהקהילה יתקבלו בברכה!

<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">מערכת דחיסת זיכרון מתמשך שנבנתה עבור <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">התחלה מהירה</a> •
  <a href="#how-it-works">איך זה עובד</a> •
  <a href="#mcp-search-tools">כלי חיפוש</a> •
  <a href="#documentation">תיעוד</a> •
  <a href="#configuration">הגדרות</a> •
  <a href="#troubleshooting">פתרון בעיות</a> •
  <a href="#license">רישיון</a>
</p>

<p align="center">
  Claude-Mem משמר הקשר בצורה חלקה בין הפעלות על ידי לכידה אוטומטית של תצפיות על שימוש בכלים, יצירת סיכומים סמנטיים, והנגשתם להפעלות עתידיות. הדבר מאפשר ל-Claude לשמור על המשכיות של ידע לגבי פרויקטים גם לאחר שהפעלות מסתיימות או מתחברות מחדש.
</p>

---

## התחלה מהירה

התקן בפקודה בודדת:

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

או התקן עבור OpenCode:

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

או התקן עבור Antigravity CLI ([מדריך הגדרה](https://docs.claude-mem.ai/antigravity-cli/setup)):

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

או התקן משוק התוספים בתוך Claude Code:

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

/plugin install claude-mem
```

הפעל מחדש את Claude Code. הקשר מהפעלות קודמות יופיע אוטומטית בהפעלות חדשות.

> **הערה:** Claude-Mem מפורסם גם ב-npm, אך `npm install -g claude-mem` מתקין רק את **ה-SDK/ספרייה** — הוא אינו רושם את hooks התוסף ואינו מגדיר את שירות ה-worker. תמיד יש להתקין באמצעות `npx claude-mem install` או פקודות `/plugin` שלעיל.

### 🦞 OpenClaw Gateway

התקן את claude-mem כתוסף זיכרון מתמשך על שערי [OpenClaw](https://openclaw.ai) בפקודה בודדת:

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

תוכנת ההתקנה מטפלת בתלויות, בהגדרת התוסף, בהגדרת ספק ה-AI, בהפעלת ה-worker, ובאפשרות להזין זרימות תצפיות בזמן אמת ל-Telegram, Discord, Slack ועוד. עיין ב[מדריך שילוב OpenClaw](https://docs.claude-mem.ai/openclaw-integration) לפרטים.

**תכונות עיקריות:**

- 🧠 **זיכרון מתמשך** - הקשר שורד בין הפעלות
- 📊 **גילוי מדורג** - אחזור זיכרון רב-שכבתי עם נראות עלות טוקנים
- 🔍 **חיפוש מבוסס-מיומנויות** - שאל את היסטוריית הפרויקט שלך עם מיומנות mem-search
- 🖥️ **ממשק צופה אינטרנט** - זרימת זיכרון בזמן אמת בכתובת ה-worker שמודפסת בעת ההפעלה
- 💻 **מיומנות Claude Desktop** - חפש זיכרון משיחות Claude Desktop
- 🔒 **בקרת פרטיות** - השתמש בתגיות `<private>` כדי להוציא תוכן רגיש מהאחסון
- ⚙️ **הגדרות הקשר** - בקרה מדויקת על איזה הקשר מוזרק
- 🤖 **פעולה אוטומטית** - אין צורך בהתערבות ידנית
- 🔗 **ציטוטים** - הפנה לתצפיות קודמות עם מזהים דרך ה-API של ה-worker או צפה בכולם בצופה האינטרנט

---

## תיעוד

📚 **[צפה בתיעוד המלא](https://docs.claude-mem.ai/)** - דפדף באתר הרשמי

### תחילת העבודה

- **[מדריך התקנה](https://docs.claude-mem.ai/installation)** - התחלה מהירה והתקנה מתקדמת
- **[מדריך שימוש](https://docs.claude-mem.ai/usage/getting-started)** - איך Claude-Mem עובד אוטומטית
- **[כלי חיפוש](https://docs.claude-mem.ai/usage/search-tools)** - שאל את היסטוריית הפרויקט שלך בשפה טבעית

### שיטות מומלצות

- **[הנדסת הקשר](https://docs.claude-mem.ai/context-engineering)** - עקרונות אופטימיזציה של הקשר לסוכן AI
- **[גילוי מדורג](https://docs.claude-mem.ai/progressive-disclosure)** - הפילוסופיה מאחורי אסטרטגיית הכנת ההקשר של Claude-Mem

### ארכיטקטורה

- **[סקירה כללית](https://docs.claude-mem.ai/architecture/overview)** - רכיבי המערכת וזרימת הנתונים
- **[התפתחות הארכיטקטורה](https://docs.claude-mem.ai/architecture-evolution)** - המסע מגרסה v3 לגרסה v5
- **[ארכיטקטורת Hooks](https://docs.claude-mem.ai/hooks-architecture)** - איך Claude-Mem משתמש ב-lifecycle hooks
- **[מדריך Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 סקריפטי hook מוסברים
- **[שירות Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API וניהול Bun
- **[מסד נתונים](https://docs.claude-mem.ai/architecture/database)** - סכמת SQLite וחיפוש FTS5
- **[ארכיטקטורת חיפוש](https://docs.claude-mem.ai/architecture/search-architecture)** - חיפוש היברידי עם מסד נתוני וקטורים Chroma

### הגדרות ופיתוח

- **[הגדרות](https://docs.claude-mem.ai/configuration)** - משתני סביבה והגדרות
- **[פיתוח](https://docs.claude-mem.ai/development)** - בנייה, בדיקה, תרומה
- **[ענפי שחרור](https://docs.claude-mem.ai/branches)** - זרימת הענפים Stable, core-dev, ו-community-edge
- **[פתרון בעיות](https://docs.claude-mem.ai/troubleshooting)** - בעיות נפוצות ופתרונות

---

## איך זה עובד

**רכיבי ליבה:**

1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 סקריפטי hook)
2. **התקנה חכמה** - בודק תלויות עם מטמון (סקריפט pre-hook, לא lifecycle hook)
3. **שירות Worker** - HTTP API מקומי עם ממשק צופה אינטרנט ונקודות קצה לחיפוש, מנוהל על ידי Bun
4. **מסד נתוני SQLite** - מאחסן הפעלות, תצפיות, סיכומים
5. **מיומנות mem-search** - שאילתות בשפה טבעית עם גילוי מדורג
6. **מסד נתוני וקטורים Chroma** - חיפוש היברידי סמנטי + מילות מפתח לאחזור הקשר חכם

ראה [סקירה כללית של הארכיטקטורה](https://docs.claude-mem.ai/architecture/overview) לפרטים.

---

## כלי חיפוש MCP

Claude-Mem מספק חיפוש זיכרון חכם באמצעות **4 כלי MCP** לפי דפוס עבודה **תלת-שכבתי** יעיל מבחינת טוקנים:

**דפוס העבודה התלת-שכבתי:**

1. **`search`** - קבל אינדקס קומפקטי עם מזהים (כ-50-100 טוקנים לתוצאה)
2. **`timeline`** - קבל הקשר כרונולוגי סביב תוצאות מעניינות
3. **`get_observations`** - שלוף פרטים מלאים רק עבור מזהים מסוננים (כ-500-1,000 טוקנים לתוצאה)

**איך זה עובד:**
- Claude משתמש בכלי MCP כדי לחפש בזיכרון שלך
- התחל עם `search` כדי לקבל אינדקס של תוצאות
- השתמש ב-`timeline` כדי לראות מה קרה סביב תצפיות ספציפיות
- השתמש ב-`get_observations` כדי לשלוף פרטים מלאים עבור מזהים רלוונטיים
- **חיסכון של פי 10 בטוקנים** על ידי סינון לפני שליפת הפרטים

**כלי MCP זמינים:**

1. **`search`** - חפש באינדקס הזיכרון עם שאילתות טקסט מלא, סינון לפי סוג/תאריך/פרויקט
2. **`timeline`** - קבל הקשר כרונולוגי סביב תצפית או שאילתה ספציפית
3. **`get_observations`** - שלוף פרטי תצפית מלאים לפי מזהים (תמיד קבץ מספר מזהים יחד)

**דוגמת שימוש:**

```typescript
// שלב 1: חיפוש לצורך קבלת אינדקס
search(query="authentication bug", type="bugfix", limit=10)

// שלב 2: סקור את האינדקס, זהה מזהים רלוונטיים (למשל, #123, #456)

// שלב 3: שלוף פרטים מלאים
get_observations(ids=[123, 456])
```

ראה [מדריך כלי חיפוש](https://docs.claude-mem.ai/usage/search-tools) לדוגמאות מפורטות.

---

## ענפי שחרור

שחרורים יציבים משוחררים מהענף `main` ומפורסמים ל-npm. `core-dev` ו-
`community-edge` הם ענפים המורצים ממקור, המיועדים לתיקוני יציבות מוקדמים ולשילובים
קהילתיים. ראה **[ענפי שחרור](https://docs.claude-mem.ai/branches)**
לזרימת הענפים ולהוראות הרצה לא-יציבות.

---

## דרישות מערכת

- **Node.js**: 20.0.0 ומעלה
- **Claude Code**: גרסה אחרונה עם תמיכה בתוספים
- **Bun**: סביבת ריצה ומנהל תהליכים של JavaScript (מותקן אוטומטית אם חסר)
- **uv**: מנהל חבילות Python לחיפוש וקטורי (מותקן אוטומטית אם חסר)
- **SQLite 3**: לאחסון מתמשך (מצורף)

---
### הערות התקנה עבור Windows

אם אתה נתקל בשגיאה כמו:

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

ודא ש-Node.js ו-npm מותקנים ומוספים ל-PATH שלך. הורד את תוכנת ההתקנה העדכנית ביותר של Node.js מ-https://nodejs.org והפעל מחדש את הטרמינל שלך לאחר ההתקנה.

---

## הגדרות

ההגדרות מנוהלות ב-`~/.claude-mem/settings.json` (נוצר אוטומטית עם ברירות מחדל בהפעלה הראשונה). הגדר מודל AI, פורט worker, ספריית נתונים, רמת לוג, והגדרות הזרקת הקשר.

ראה **[מדריך הגדרות](https://docs.claude-mem.ai/configuration)** לכל ההגדרות הזמינות ודוגמאות.

### הגדרת מצב ושפה

Claude-Mem תומך במספר מצבי עבודה ושפות דרך ההגדרה `CLAUDE_MEM_MODE`.

אפשרות זו שולטת בשני דברים:
- התנהגות זרימת העבודה (למשל code, chill, investigation)
- השפה המשמשת בתצפיות שנוצרות

#### איך להגדיר

ערוך את קובץ ההגדרות שלך ב-`~/.claude-mem/settings.json`:

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

מצבים מוגדרים ב-`plugin/modes/`. כדי לראות את כל המצבים הזמינים מקומית:

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

#### מצבים זמינים

| מצב | תיאור |
|------------|-------------------------|
| `code` | מצב ברירת מחדל באנגלית |
| `code--zh` | מצב סינית פשוטה |
| `code--ja` | מצב יפנית |

מצבי שפה ספציפיים עוקבים אחר התבנית `code--[lang]` כאשר `[lang]` הוא קוד השפה בתקן ISO 639-1 (למשל, `zh` עבור סינית, `ja` עבור יפנית, `es` עבור ספרדית).

> הערה: `code--zh` (סינית פשוטה) כבר מובנה — אין צורך בהתקנה נוספת או עדכון תוסף.

#### לאחר שינוי מצב

הפעל מחדש את Claude Code כדי להחיל את הגדרת המצב החדשה.
---

## פיתוח

ראה **[מדריך פיתוח](https://docs.claude-mem.ai/development)** להוראות בנייה, בדיקה, ותהליך תרומה.

---

## פתרון בעיות

אם אתה נתקל בבעיות, תאר את הבעיה ל-Claude ומיומנות troubleshoot תאבחן אוטומטית ותספק תיקונים.

ראה **[מדריך פתרון בעיות](https://docs.claude-mem.ai/troubleshooting)** לבעיות נפוצות ופתרונות.

---

## דיווחי באגים

צור דיווחי באגים מקיפים עם המחולל האוטומטי:

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

## תרומה

תרומות מתקבלות בברכה! אנא:

1. עשה Fork למאגר
2. צור ענף תכונה
3. בצע את השינויים שלך עם בדיקות
4. עדכן תיעוד
5. שלח Pull Request

Claude-Mem משוחרר משלושה ענפים: `main` (יציב), `core-dev`, ו-
`community-edge`. רק `main` מפורסם ל-npm; האחרים מורצים ממקור.
ראה [ענפי שחרור](https://docs.claude-mem.ai/branches) לאסטרטגיה ולהוראות
הרצה מקומיות.

ראה [מדריך פיתוח](https://docs.claude-mem.ai/development) לתהליך תרומה.

---

## רישיון

Claude-Mem מופץ תחת רישיון Apache License 2.0.

בחרנו ב-Apache-2.0 מכיוון שזיכרון סוכני עמיד צריך להיות קל לשילוב בכלי
פיתוח, בסוכנים מקומיים, בשרתי MCP, במערכות ארגוניות, במערכי רובוטיקה,
ובתשתיות סוכנים בייצור.

ראה את קובץ ה-[LICENSE](LICENSE) לפרטים מלאים. ראה [docs/license.md](docs/license.md)
ו-[docs/ip-boundary.md](docs/ip-boundary.md) להיקף הרישוי ולגבול
הקוד הפתוח/מסחרי.

**הערה בנוגע ל-Ragtime**: הספרייה `ragtime/` מופצת תחת **Apache License 2.0**. ראה [ragtime/LICENSE](ragtime/LICENSE) לפרטים.

---

## תמיכה

- **תיעוד**: [docs/](docs/)
- **בעיות**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **מאגר**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **חשבון X רשמי**: [@Claude_Memory](https://x.com/Claude_Memory)
- **דיסקורד רשמי**: [הצטרף לדיסקורד](https://discord.com/invite/J4wttp9vDu)
- **מחבר**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**נבנה עם Claude Agent SDK** | **פועל עם Claude Code** | **נוצר עם TypeScript**

---

### מה לגבי CMEM?

CMEM הוא טוקן שנוצר על ידי צד שלישי, אך מקבל תמיכה רשמית מיוצר Claude-Mem (Alex Newman, @thedotmack). הטוקן משמש כזרז קהילתי לצמיחה וככלי להנגשת CMEM למפתחים ולעובדי ידע הזקוקים לו ביותר.

כתובת חוזה רשמית ברשת BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3