🌐 Bu otomatik bir çevirisidir. Topluluk düzeltmeleri memnuniyetle karşılanır!

<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> için geliştirilmiş kalıcı bellek sıkıştırma sistemi.</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">Hızlı Başlangıç</a> •
  <a href="#how-it-works">Nasıl Çalışır</a> •
  <a href="#mcp-search-tools">Arama Araçları</a> •
  <a href="#documentation">Dokümantasyon</a> •
  <a href="#configuration">Yapılandırma</a> •
  <a href="#troubleshooting">Sorun Giderme</a> •
  <a href="#license">Lisans</a>
</p>

<p align="center">
  Claude-Mem, araç kullanım gözlemlerini otomatik olarak yakalayarak, anlamsal özetler oluşturarak ve bunları gelecekteki oturumlarda kullanılabilir hale getirerek bağlamı oturumlar arası sorunsuzca korur. Bu, Claude'un oturumlar sona erse veya yeniden bağlansa bile projeler hakkındaki bilgi sürekliliğini korumasını sağlar.
</p>

---

## Quick Start

Tek bir komutla kurun:

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

Ya da OpenCode için kurun:

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

Ya da Antigravity CLI için kurun ([kurulum kılavuzu](https://docs.claude-mem.ai/antigravity-cli/setup)):

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

Ya da Claude Code içindeki plugin pazaryerinden kurun:

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

/plugin install claude-mem
```

Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak yeni oturumlarda görünecektir.

> **Not:** Claude-Mem npm'de de yayımlanmıştır, ancak `npm install -g claude-mem` yalnızca **SDK/kütüphaneyi** kurar — plugin hook'larını kaydetmez veya worker servisini kurmaz. Her zaman `npx claude-mem install` veya yukarıdaki `/plugin` komutlarıyla kurun.

### 🦞 OpenClaw Gateway

Claude-mem'i tek bir komutla [OpenClaw](https://openclaw.ai) gateway'lerine kalıcı bellek eklentisi olarak kurun:

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

Kurulum programı bağımlılıkları, plugin kurulumunu, AI sağlayıcı yapılandırmasını, worker başlatmayı ve Telegram, Discord, Slack ve daha fazlasına isteğe bağlı gerçek zamanlı gözlem akışlarını yönetir. Detaylar için [OpenClaw Entegrasyon Kılavuzu](https://docs.claude-mem.ai/openclaw-integration) bölümüne bakın.

**Temel Özellikler:**

- 🧠 **Kalıcı Bellek** - Bağlam oturumlar arası hayatta kalır
- 📊 **Aşamalı Açıklama** - Token maliyeti görünürlüğü ile katmanlı bellek erişimi
- 🔍 **Beceri Tabanlı Arama** - mem-search becerisi ile proje geçmişinizi sorgulayın
- 🖥️ **Web Görüntüleyici Arayüzü** - Başlangıçta yazdırılan worker URL'sinde gerçek zamanlı bellek akışı
- 💻 **Claude Desktop Becerisi** - Claude Desktop konuşmalarından bellek araması yapın
- 🔒 **Gizlilik Kontrolü** - Hassas içeriği depolamadan hariç tutmak için `<private>` etiketlerini kullanın
- ⚙️ **Bağlam Yapılandırması** - Hangi bağlamın enjekte edileceği üzerinde detaylı kontrol
- 🤖 **Otomatik Çalışma** - Manuel müdahale gerektirmez
- 🔗 **Alıntılar** - Worker API üzerinden ID'lerle geçmiş gözlemlere referans verin veya tümünü web görüntüleyicide görüntüleyin

---

## Documentation

📚 **[Tam Dokümantasyonu Görüntüle](https://docs.claude-mem.ai/)** - Resmi web sitesinde göz atın

### Başlarken

- **[Kurulum Kılavuzu](https://docs.claude-mem.ai/installation)** - Hızlı başlangıç ve gelişmiş kurulum
- **[Kullanım Kılavuzu](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem otomatik olarak nasıl çalışır
- **[Arama Araçları](https://docs.claude-mem.ai/usage/search-tools)** - Doğal dil ile proje geçmişinizi sorgulayın

### En İyi Uygulamalar

- **[Bağlam Mühendisliği](https://docs.claude-mem.ai/context-engineering)** - AI ajan bağlam optimizasyon ilkeleri
- **[Aşamalı Açıklama](https://docs.claude-mem.ai/progressive-disclosure)** - Claude-Mem'in bağlam hazırlama stratejisinin ardındaki felsefe

### Mimari

- **[Genel Bakış](https://docs.claude-mem.ai/architecture/overview)** - Sistem bileşenleri ve veri akışı
- **[Mimari Evrimi](https://docs.claude-mem.ai/architecture-evolution)** - v3'ten v5'e yolculuk
- **[Hooks Mimarisi](https://docs.claude-mem.ai/hooks-architecture)** - Claude-Mem yaşam döngüsü hook'larını nasıl kullanır
- **[Hooks Referansı](https://docs.claude-mem.ai/architecture/hooks)** - 7 hook betiği açıklandı
- **[Worker Servisi](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API ve Bun yönetimi
- **[Veritabanı](https://docs.claude-mem.ai/architecture/database)** - SQLite şeması ve FTS5 arama
- **[Arama Mimarisi](https://docs.claude-mem.ai/architecture/search-architecture)** - Chroma vektör veritabanı ile hibrit arama

### Yapılandırma ve Geliştirme

- **[Yapılandırma](https://docs.claude-mem.ai/configuration)** - Ortam değişkenleri ve ayarlar
- **[Geliştirme](https://docs.claude-mem.ai/development)** - Derleme, test etme, katkıda bulunma
- **[Sürüm Dalları](https://docs.claude-mem.ai/branches)** - Stable, core-dev ve community-edge dal akışı
- **[Sorun Giderme](https://docs.claude-mem.ai/troubleshooting)** - Yaygın sorunlar ve çözümler

---

## How It Works

**Temel Bileşenler:**

1. **5 Yaşam Döngüsü Hook'u** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook betiği)
2. **Akıllı Kurulum** - Önbelleğe alınmış bağımlılık kontrolcüsü (ön-hook betiği, yaşam döngüsü hook'u değil)
3. **Worker Servisi** - Web görüntüleyici arayüzü ve arama uç noktaları ile yerel HTTP API, Bun tarafından yönetilir
4. **SQLite Veritabanı** - Oturumları, gözlemleri, özetleri saklar
5. **mem-search Becerisi** - Aşamalı açıklama ile doğal dil sorguları
6. **Chroma Vektör Veritabanı** - Akıllı bağlam erişimi için hibrit anlamsal + anahtar kelime arama

Detaylar için [Mimari Genel Bakış](https://docs.claude-mem.ai/architecture/overview) bölümüne bakın.

---

## MCP Search Tools

Claude-Mem, token açısından verimli bir **3 katmanlı iş akışı düzeni**ni takip eden **4 MCP aracı** aracılığıyla akıllı bellek araması sağlar:

**3 Katmanlı İş Akışı:**

1. **`search`** - ID'lerle kompakt bir indeks alın (~50-100 token/sonuç)
2. **`timeline`** - İlgi çekici sonuçların çevresindeki kronolojik bağlamı alın
3. **`get_observations`** - Yalnızca filtrelenmiş ID'ler için tam detayları getirin (~500-1.000 token/sonuç)

**Nasıl Çalışır:**
- Claude, belleğinizi aramak için MCP araçlarını kullanır
- Sonuçların bir indeksini almak için `search` ile başlayın
- Belirli gözlemlerin çevresinde neler olduğunu görmek için `timeline` kullanın
- İlgili ID'ler için tam detayları getirmek üzere `get_observations` kullanın
- Detayları getirmeden önce filtreleme yaparak **~10 kat token tasarrufu** sağlanır

**Mevcut MCP Araçları:**

1. **`search`** - Tam metin sorgularıyla bellek indeksini arayın, türe/tarihe/projeye göre filtreleyin
2. **`timeline`** - Belirli bir gözlem veya sorgu etrafındaki kronolojik bağlamı alın
3. **`get_observations`** - ID'lere göre tam gözlem detaylarını getirin (her zaman birden fazla ID'yi toplu olarak işleyin)

**Örnek Kullanım:**

```typescript
// Adım 1: İndeks için arama yapın
search(query="authentication bug", type="bugfix", limit=10)

// Adım 2: İndeksi inceleyin, ilgili ID'leri belirleyin (örn. #123, #456)

// Adım 3: Tam detayları getirin
get_observations(ids=[123, 456])
```

Detaylı örnekler için [Arama Araçları Kılavuzu](https://docs.claude-mem.ai/usage/search-tools) bölümüne bakın.

---

## Release Branches

Kararlı sürümler `main` dalından yayımlanır ve npm'e gönderilir. `core-dev` ve
`community-edge`, erken güvenilirlik düzeltmeleri ve topluluk entegrasyonları için
kaynaktan çalıştırılan dallardır. Dal akışı ve kararlı olmayan çalıştırma talimatları
için **[Sürüm Dalları](https://docs.claude-mem.ai/branches)** bölümüne bakın.

---

## System Requirements

- **Node.js**: 20.0.0 veya üzeri
- **Claude Code**: Plugin desteği olan en son sürüm
- **Bun**: JavaScript çalışma zamanı ve işlem yöneticisi (eksikse otomatik kurulur)
- **uv**: Vektör arama için Python paket yöneticisi (eksikse otomatik kurulur)
- **SQLite 3**: Kalıcı depolama için (dahildir)

---
### Windows Kurulum Notları

Aşağıdaki gibi bir hata görürseniz:

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

Node.js ve npm'in kurulu olduğundan ve PATH'inize eklendiğinden emin olun. https://nodejs.org adresinden en son Node.js kurulum dosyasını indirin ve kurulumdan sonra terminalinizi yeniden başlatın.

---

## Configuration

Ayarlar `~/.claude-mem/settings.json` dosyasında yönetilir (ilk çalıştırmada varsayılanlarla otomatik oluşturulur). AI modelini, worker portunu, veri dizinini, log seviyesini ve bağlam enjeksiyon ayarlarını yapılandırın.

Tüm mevcut ayarlar ve örnekler için **[Yapılandırma Kılavuzu](https://docs.claude-mem.ai/configuration)** bölümüne bakın.

### Mod ve Dil Yapılandırması

Claude-Mem, `CLAUDE_MEM_MODE` ayarı aracılığıyla birden fazla iş akışı modunu ve dili destekler.

Bu seçenek şunları kontrol eder:
- İş akışı davranışını (örn. code, chill, investigation)
- Oluşturulan gözlemlerde kullanılan dili

#### Nasıl Yapılandırılır

`~/.claude-mem/settings.json` konumundaki ayarlar dosyanızı düzenleyin:

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

Modlar `plugin/modes/` içinde tanımlanır. Mevcut tüm modları yerel olarak görmek için:

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

#### Mevcut Modlar

| Mod | Açıklama |
|------------|-------------------------|
| `code` | Varsayılan İngilizce mod |
| `code--zh` | Basitleştirilmiş Çince mod |
| `code--ja` | Japonca mod |

Dile özgü modlar `code--[dil]` düzenini takip eder; burada `[dil]`, ISO 639-1 dil kodudur (örn. Çince için `zh`, Japonca için `ja`, İspanyolca için `es`).

> Not: `code--zh` (Basitleştirilmiş Çince) zaten dahil edilmiştir — ek bir kurulum veya plugin güncellemesi gerekmez.

#### Mod Değiştirdikten Sonra

Yeni mod yapılandırmasını uygulamak için Claude Code'u yeniden başlatın.
---

## Development

Derleme talimatları, test etme ve katkı iş akışı için **[Geliştirme Kılavuzu](https://docs.claude-mem.ai/development)** bölümüne bakın.

---

## Troubleshooting

Sorunlarla karşılaşırsanız, sorunu Claude'a açıklayın ve troubleshoot becerisi otomatik olarak teşhis edip düzeltmeleri sağlayacaktır.

Yaygın sorunlar ve çözümler için **[Sorun Giderme Kılavuzu](https://docs.claude-mem.ai/troubleshooting)** bölümüne bakın.

---

## Bug Reports

Otomatik oluşturucu ile kapsamlı hata raporları oluşturun:

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

## Contributing

Katkılar memnuniyetle karşılanır! Lütfen:

1. Depoyu fork edin
2. Bir özellik dalı oluşturun
3. Testlerle değişikliklerinizi yapın
4. Dokümantasyonu güncelleyin
5. Pull Request gönderin

Claude-Mem üç daldan yayımlanır: `main` (kararlı), `core-dev` ve
`community-edge`. Yalnızca `main` npm'e yayımlanır; diğerleri kaynaktan
çalıştırılır. Strateji ve yerel çalıştırma talimatları için
[Sürüm Dalları](https://docs.claude-mem.ai/branches) bölümüne bakın.

Katkı iş akışı için [Geliştirme Kılavuzu](https://docs.claude-mem.ai/development) bölümüne bakın.

---

## License

Claude-Mem, Apache License 2.0 lisansı altında lisanslanmıştır.

Apache-2.0'ı seçtik çünkü kalıcı ajan belleğinin geliştirici araçlarına, yerel
ajanlara, MCP sunucularına, kurumsal sistemlere, robotik yığınlarına ve üretim
ajan altyapılarına kolayca gömülebilir olması gerekiyor.

Tüm detaylar için [LICENSE](LICENSE) dosyasına bakın. Lisanslama kapsamı ve
açık/ticari sınır için [docs/license.md](docs/license.md) ve
[docs/ip-boundary.md](docs/ip-boundary.md) bölümlerine bakın.

**Ragtime ile ilgili not**: `ragtime/` dizini **Apache License 2.0** altında lisanslanmıştır. Detaylar için [ragtime/LICENSE](ragtime/LICENSE) bölümüne bakın.

---

## Support

- **Dokümantasyon**: [docs/](docs/)
- **Sorunlar**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Depo**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Resmi X Hesabı**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Resmi Discord**: [Discord'a Katıl](https://discord.com/invite/J4wttp9vDu)
- **Yazar**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Claude Agent SDK ile geliştirilmiştir** | **Claude Code ile çalışır** | **TypeScript ile yapılmıştır**

---

### CMEM Ne Demek?

CMEM, 3. bir taraf tarafından oluşturulan ancak Claude-Mem'in yaratıcısı (Alex Newman, @thedotmack) tarafından resmi olarak benimsenen bir token'dır. Bu token, büyüme için bir topluluk katalizörü ve CMEM'i en çok ihtiyaç duyan geliştiricilere ve bilgi çalışanlarına ulaştırmak için bir araç olarak işlev görür.

Resmi BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3