cc-viewer 1.2.0 → 1.2.2

package/concepts/tr/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Tanım
+
+Ana konuşmada bir beceri (skill) çalıştırır. Beceriler, kullanıcının slash command (örn. `/commit`, `/review-pr`) aracılığıyla çağırabileceği özel yeteneklerdir.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `skill` | string | Evet | Beceri adı (örn. "commit", "review-pr", "pdf") |
+| `args` | string | Hayır | Beceri parametreleri |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Kullanıcı `/<skill-name>` formatında slash command girdiğinde
+- Kullanıcının isteği kayıtlı bir becerinin işlevselliğiyle eşleştiğinde
+
+**Kullanıma uygun değil:**
+- Yerleşik CLI komutları (örn. `/help`, `/clear`)
+- Zaten çalışmakta olan bir beceri
+- Kullanılabilir beceri listesinde olmayan beceri adları
+
+## Dikkat Edilecekler
+
+- Beceri çağrıldıktan sonra tam bir prompt'a genişletilir
+- Tam nitelikli adları destekler (örn. `ms-office-suite:pdf`)
+- Kullanılabilir beceri listesi system-reminder mesajlarında sağlanır
+- `<command-name>` etiketi görüldüğünde beceri zaten yüklenmiş demektir, bu aracı tekrar çağırmak yerine doğrudan çalıştırılmalıdır
+- Aracı gerçekten çağırmadan bir beceriden bahsetmeyin
+
+## cc-viewer'da Önemi
+
+Skill çağrıları istek günlüğünde `tool_use` content block olarak görünür. Beceri genişletildikten sonraki prompt, sonraki isteklerin system prompt'unu veya mesaj içeriğini etkiler.

package/concepts/tr/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Tanım
+
+Karmaşık çok adımlı görevleri otonom olarak işlemek için bir alt agent (SubAgent) başlatır. Alt agent'lar bağımsız alt süreçlerdir ve her birinin kendine özel araç seti ve bağlamı vardır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `prompt` | string | Evet | Alt agent'ın yürüteceği görev açıklaması |
+| `description` | string | Evet | 3-5 kelimelik kısa özet |
+| `subagent_type` | string | Evet | Alt agent türü, kullanılabilir araç setini belirler |
+| `model` | enum | Hayır | Model belirtme (sonnet / opus / haiku), varsayılan üst seviyeden miras |
+| `max_turns` | integer | Hayır | Maksimum agentic tur sayısı |
+| `run_in_background` | boolean | Hayır | Arka planda çalıştırılıp çalıştırılmayacağı, arka plan görevleri output_file yolu döndürür |
+| `resume` | string | Hayır | Devam ettirilecek agent ID'si, son yürütmeden devam eder |
+| `isolation` | enum | Hayır | İzolasyon modu, `worktree` geçici git worktree oluşturur |
+
+## Alt Agent Türleri
+
+| Tür | Kullanım Amacı | Kullanılabilir Araçlar |
+|-----|----------------|----------------------|
+| `Bash` | Komut çalıştırma, git işlemleri | Bash |
+| `general-purpose` | Genel amaçlı çok adımlı görevler | Tüm araçlar |
+| `Explore` | Hızlı kod tabanı keşfi | Task/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
+| `Plan` | Uygulama planı tasarlama | Task/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
+| `claude-code-guide` | Claude Code kullanım kılavuzu soru-cevap | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Durum çubuğu yapılandırma | Read, Edit |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Çok adımlı otonom tamamlama gerektiren karmaşık görevler
+- Kod tabanı keşfi ve derinlemesine araştırma (Explore türü ile)
+- İzole ortam gerektiren paralel çalışma
+- Arka planda çalıştırılması gereken uzun süreli görevler
+
+**Kullanıma uygun değil:**
+- Belirli dosya yolunu okuma — doğrudan Read veya Glob kullanın
+- 2-3 bilinen dosyada arama — doğrudan Read kullanın
+- Belirli sınıf tanımı arama — doğrudan Glob kullanın
+
+## Dikkat Edilecekler
+
+- Alt agent tamamlandığında tek bir mesaj döndürür; sonuçları kullanıcıya görünmez, ana agent'ın aktarması gerekir
+- Verimliliği artırmak için tek mesajda birden fazla paralel Task çağrısı yapılabilir
+- Arka plan görevleri TaskOutput aracıyla ilerleme kontrolü yapılır
+- Explore türü doğrudan Glob/Grep çağrısından yavaştır, yalnızca basit arama yeterli olmadığında kullanın
+
+## cc-viewer'da Önemi
+
+Task çağrıları SubAgent istek zinciri oluşturur; istek listesinde MainAgent'tan bağımsız alt istek dizileri görülebilir. SubAgent istekleri genellikle kısaltılmış system prompt ve daha az araç tanımına sahiptir ve MainAgent ile belirgin bir kontrast oluşturur.

package/concepts/tr/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Tanım
+
+İlerlemeyi izlemek, karmaşık görevleri organize etmek ve kullanıcıya çalışma ilerlemesini göstermek için yapılandırılmış görev listesi girdisi oluşturur.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `subject` | string | Evet | Kısa görev başlığı, emir kipi kullanılır (örn. "Fix authentication bug") |
+| `description` | string | Evet | Bağlam ve kabul kriterleri dahil ayrıntılı açıklama |
+| `activeForm` | string | Hayır | Devam ederken gösterilen şimdiki zaman metni (örn. "Fixing authentication bug") |
+| `metadata` | object | Hayır | Göreve eklenen rastgele meta veriler |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Karmaşık çok adımlı görevler (3 adımdan fazla)
+- Kullanıcı birden fazla yapılacak iş sağladığında
+- Planlama modunda çalışmayı izleme
+- Kullanıcı açıkça todo listesi kullanılmasını istediğinde
+
+**Kullanıma uygun değil:**
+- Tek basit görev
+- 3 adımdan az basit işlemler
+- Salt konuşma veya bilgi sorgusu
+
+## Dikkat Edilecekler
+
+- Tüm yeni görevlerin başlangıç durumu `pending`'dir
+- `subject` emir kipi kullanır ("Run tests"), `activeForm` şimdiki zaman kullanır ("Running tests")
+- Oluşturulduktan sonra TaskUpdate ile bağımlılık ilişkileri (blocks/blockedBy) ayarlanabilir
+- Oluşturmadan önce TaskList ile mükerrer görev olup olmadığı kontrol edilmelidir
+
+## cc-viewer'da Önemi
+
+TaskCreate, Claude Code'un dahili görev yönetim işlemidir ve bağımsız API isteği üretmez. Ancak Chat Mode'da modelin bu aracı çağırdığı tool_use block görülebilir.

package/concepts/tr/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Tanım
+
+Görev ID'si ile görevin tam detaylarını alır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `taskId` | string | Evet | Alınacak görev ID'si |
+
+## Dönen İçerik
+
+- `subject` — Görev başlığı
+- `description` — Ayrıntılı gereksinimler ve bağlam
+- `status` — Durum: `pending`, `in_progress` veya `completed`
+- `blocks` — Bu görev tarafından engellenen görev listesi
+- `blockedBy` — Bu görevi engelleyen ön koşul görev listesi
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Çalışmaya başlamadan önce görevin tam açıklamasını ve bağlamını alma
+- Görev bağımlılıklarını anlama
+- Görev atandıktan sonra tam gereksinimleri alma
+
+## Dikkat Edilecekler
+
+- Görevi aldıktan sonra çalışmaya başlamadan önce `blockedBy` listesinin boş olup olmadığı kontrol edilmelidir
+- Tüm görevlerin özet bilgilerini görmek için TaskList kullanın
+
+## cc-viewer'da Önemi
+
+TaskGet dahili görev yönetim işlemidir ve bağımsız API isteği üretmez.

package/concepts/tr/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Tanım
+
+Görev listesindeki tüm görevleri listeler, genel ilerlemeyi ve mevcut çalışmaları görüntüler.
+
+## Parametreler
+
+Parametre yok.
+
+## Dönen İçerik
+
+Her görevin özet bilgileri:
+- `id` — Görev tanımlayıcısı
+- `subject` — Kısa açıklama
+- `status` — Durum: `pending`, `in_progress` veya `completed`
+- `owner` — Sorumlu kişi (agent ID), boş ise atanmamış
+- `blockedBy` — Bu görevi engelleyen tamamlanmamış görev ID listesi
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Mevcut görevleri görme (durumu pending, owner'ı yok, engellenmemiş)
+- Proje genel ilerlemesini kontrol etme
+- Engellenen görevleri bulma
+- Bir görevi tamamladıktan sonra bir sonrakini bulma
+
+## Dikkat Edilecekler
+
+- Görevleri ID sırasına göre işlemeyi tercih edin (en küçük ID önce), çünkü erken görevler genellikle sonraki görevler için bağlam sağlar
+- `blockedBy` olan görevler bağımlılık çözülmeden sahiplenilemez
+- Belirli bir görevin tam detayları için TaskGet kullanın
+
+## cc-viewer'da Önemi
+
+TaskList dahili görev yönetim işlemidir ve bağımsız API isteği üretmez.

package/concepts/tr/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Tanım
+
+Çalışan veya tamamlanmış arka plan görevinin çıktısını alır. Arka plan shell'leri, asenkron agent'lar ve uzak oturumlar için uygundur.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `task_id` | string | Evet | Görev ID'si |
+| `block` | boolean | Evet | Görev tamamlanana kadar beklenip beklenmeyeceği, varsayılan `true` |
+| `timeout` | number | Evet | Maksimum bekleme süresi (milisaniye), varsayılan 30000, maksimum 600000 |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Task (`run_in_background: true`) ile başlatılan arka plan agent'ının ilerlemesini kontrol etme
+- Arka plan Bash komutunun çalıştırma sonucunu alma
+- Asenkron görevin tamamlanmasını bekleyip çıktısını alma
+
+**Kullanıma uygun değil:**
+- Ön plan görevleri — ön plan görevleri doğrudan sonuç döndürür, bu araca gerek yoktur
+
+## Dikkat Edilecekler
+
+- `block: true` görev tamamlanana veya zaman aşımına uğrayana kadar engeller
+- `block: false` mevcut durumu engellemeden kontrol etmek için kullanılır
+- Görev ID'si `/tasks` komutuyla bulunabilir
+- Tüm görev türleri için geçerlidir: arka plan shell, asenkron agent, uzak oturum
+
+## cc-viewer'da Önemi
+
+TaskOutput çağrısı kendisi API isteği üretmez; Claude Code'un dahili görev yönetim işlemidir ve istek günlüğünde görünmez.

package/concepts/tr/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Tanım
+
+Çalışan bir arka plan görevini durdurur.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `task_id` | string | Hayır | Durdurulacak arka plan görev ID'si |
+| `shell_id` | string | Hayır | Kullanımdan kaldırıldı, `task_id` kullanın |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Artık gerekli olmayan uzun süreli görevleri sonlandırma
+- Yanlışlıkla başlatılan arka plan görevlerini iptal etme
+
+## Dikkat Edilecekler
+
+- Başarı veya başarısızlık durumu döndürür
+- `shell_id` parametresi kullanımdan kaldırılmıştır, `task_id` kullanılmalıdır
+
+## cc-viewer'da Önemi
+
+TaskStop çağrısı kendisi API isteği üretmez; Claude Code'un dahili görev yönetim işlemidir.

package/concepts/tr/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Tanım
+
+Görev listesindeki bir görevin durumunu, içeriğini veya bağımlılık ilişkilerini günceller.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `taskId` | string | Evet | Güncellenecek görev ID'si |
+| `status` | enum | Hayır | Yeni durum: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Hayır | Yeni başlık |
+| `description` | string | Hayır | Yeni açıklama |
+| `activeForm` | string | Hayır | Devam ederken gösterilen şimdiki zaman metni |
+| `owner` | string | Hayır | Yeni görev sorumlusu (agent adı) |
+| `metadata` | object | Hayır | Birleştirilecek meta veriler (null olarak ayarlamak anahtarı siler) |
+| `addBlocks` | string[] | Hayır | Bu görev tarafından engellenen görev ID listesi |
+| `addBlockedBy` | string[] | Hayır | Bu görevi engelleyen ön koşul görev ID listesi |
+
+## Durum Geçişi
+
+```
+pending → in_progress → completed
+```
+
+`deleted` herhangi bir durumdan geçilebilir ve görevi kalıcı olarak kaldırır.
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Çalışmaya başlarken görevi `in_progress` olarak işaretleme
+- Çalışma tamamlandığında görevi `completed` olarak işaretleme
+- Görevler arası bağımlılık ilişkilerini ayarlama
+- Gereksinimler değiştiğinde görev içeriğini güncelleme
+
+**Önemli kurallar:**
+- Yalnızca görev tamamen tamamlandığında `completed` olarak işaretleyin
+- Hata veya engelle karşılaşıldığında `in_progress` olarak bırakın
+- Test başarısız, uygulama eksik veya çözülmemiş hatalarla karşılaşıldığında `completed` olarak işaretlemeyin
+
+## Dikkat Edilecekler
+
+- Güncellemeden önce TaskGet ile görevin en son durumunu alın, eski verileri önleyin
+- Görevi tamamladıktan sonra TaskList ile bir sonraki mevcut görevi bulun
+
+## cc-viewer'da Önemi
+
+TaskUpdate dahili görev yönetim işlemidir ve bağımsız API isteği üretmez.

package/concepts/tr/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Tanım
+
+Belirtilen URL'nin web sayfası içeriğini çeker, HTML'yi markdown'a dönüştürür ve prompt'a göre AI modeli ile içeriği işler.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `url` | string (URI) | Evet | Çekilecek tam URL |
+| `prompt` | string | Evet | Sayfadan hangi bilginin çıkarılacağını açıklar |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Herkese açık web sayfalarının içeriğini alma
+- Çevrimiçi belgelere başvurma
+- Web sayfasından belirli bilgileri çıkarma
+
+**Kullanıma uygun değil:**
+- Kimlik doğrulama gerektiren URL'ler (Google Docs, Confluence, Jira, GitHub vb.) — önce özel MCP aracı aranmalıdır
+- GitHub URL'leri — öncelikle `gh` CLI kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- URL tam ve geçerli bir URL olmalıdır
+- HTTP otomatik olarak HTTPS'ye yükseltilir
+- İçerik çok büyükse sonuçlar özetlenebilir
+- 15 dakikalık otomatik temizlenen önbellek içerir
+- URL farklı bir ana bilgisayara yönlendirildiğinde, araç yönlendirme URL'sini döndürür ve yeni URL ile tekrar istek yapılması gerekir
+- MCP tarafından sağlanan web fetch aracı mevcutsa, onu tercih edin
+
+## cc-viewer'da Önemi
+
+WebFetch çağrıları istek günlüğünde `tool_use` / `tool_result` content block çifti olarak görünür. `tool_result` AI tarafından işlenmiş web sayfası içerik özetini içerir.

package/concepts/tr/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Tanım
+
+Arama motoru sorgusu çalıştırır ve güncel bilgi almak için arama sonuçlarını döndürür.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `query` | string | Evet | Arama sorgusu (en az 2 karakter) |
+| `allowed_domains` | string[] | Hayır | Yalnızca bu alan adlarından sonuçları dahil et |
+| `blocked_domains` | string[] | Hayır | Bu alan adlarından sonuçları hariç tut |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Modelin bilgi kesme tarihini aşan güncel bilgileri alma
+- Güncel olayları ve en son verileri bulma
+- En güncel teknik belgeleri arama
+
+## Dikkat Edilecekler
+
+- Arama sonuçları markdown köprü formatında döndürülür
+- Kullanımdan sonra yanıtın sonuna "Sources:" bölümü eklenmeli ve ilgili URL'ler listelenmelidir
+- Alan adı filtrelemeyi destekler (dahil etme/hariç tutma)
+- Arama sorgusunda güncel yıl kullanılmalıdır
+- Yalnızca ABD'de kullanılabilir
+
+## cc-viewer'da Önemi
+
+WebSearch çağrıları istek günlüğünde `tool_use` / `tool_result` content block çifti olarak görünür. `tool_result` arama sonuçları listesini içerir.

package/concepts/tr/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Tanım
+
+İçeriği yerel dosya sistemine yazar. Dosya zaten mevcutsa üzerine yazar.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `file_path` | string | Evet | Dosyanın mutlak yolu (mutlak yol olmalıdır) |
+| `content` | string | Evet | Yazılacak içerik |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Yeni dosya oluşturma
+- Dosya içeriğinin tamamen yeniden yazılması gerektiğinde
+
+**Kullanıma uygun değil:**
+- Dosyadaki kısmi içeriği değiştirme — Edit kullanılmalıdır
+- Kullanıcı açıkça istemediği sürece proaktif olarak belge dosyaları (*.md) veya README oluşturulmamalıdır
+
+## Dikkat Edilecekler
+
+- Hedef dosya zaten mevcutsa, önce Read ile okunmuş olmalıdır, aksi takdirde başarısız olur
+- Mevcut dosyanın tüm içeriğini üzerine yazar
+- Mevcut dosyaları düzenlemek için Edit'i tercih edin; Write yalnızca yeni dosya oluşturma veya tamamen yeniden yazma için kullanılır
+
+## cc-viewer'da Önemi
+
+Write çağrıları istek günlüğünde `tool_use` content block olarak görünür; `input.content` yazılan tam içeriği içerir.

package/concepts/tr/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## Tanım
+
+Mevcut notebook dosyasının Jupyter kernel'ında Python kodu çalıştırır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `code` | string | Evet | Çalıştırılacak Python kodu |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Jupyter notebook ortamında kod çalıştırma
+- Kod parçacıklarını test etme
+- Veri analizi ve hesaplama
+
+**Kullanıma uygun değil:**
+- Jupyter dışı ortamda kod çalıştırma — Bash kullanılmalıdır
+- Dosya değiştirme — Edit veya Write kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
+- Kod mevcut Jupyter kernel'ında çalıştırılır, durum çağrılar arasında kalıcıdır
+- Kullanıcı açıkça istemediği sürece değişken tanımlamaktan veya kernel durumunu değiştirmekten kaçınılmalıdır
+- Kernel yeniden başlatıldığında durum kaybolur
+
+## cc-viewer'da Önemi
+
+executeCode bir MCP aracıdır ve istek günlüğünün `tools` dizisinde `mcp__ide__executeCode` adıyla görünür. Çağrıları ve dönüşleri standart `tool_use` / `tool_result` kalıbını izler. MCP araçlarının eklenmesi veya kaldırılması tools dizisinin değişmesine neden olur ve önbellek yeniden oluşturmayı tetikleyebilir.

package/concepts/tr/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Tanım
+
+VS Code'dan sözdizimi hataları, tür hataları, lint uyarıları gibi dil tanılama bilgilerini alır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `uri` | string | Hayır | Dosya URI'si. Belirtilmezse tüm dosyaların tanılama bilgilerini alır |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Kodun sözdizimi, tür, lint gibi anlamsal sorunlarını kontrol etme
+- Kod düzenledikten sonra yeni hata oluşup oluşmadığını doğrulama
+- Kod kalitesini kontrol etmek için Bash komutlarının yerine kullanma
+
+**Kullanıma uygun değil:**
+- Test çalıştırma — Bash kullanılmalıdır
+- Çalışma zamanı hatalarını kontrol etme — kodu çalıştırmak için Bash kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
+- Yalnızca VS Code / IDE ortamında kullanılabilir
+- Kod sorunlarını kontrol etmek için Bash komutları yerine bu aracı tercih edin
+
+## cc-viewer'da Önemi
+
+getDiagnostics bir MCP aracıdır ve istek günlüğünün `tools` dizisinde `mcp__ide__getDiagnostics` adıyla görünür. Çağrıları ve dönüşleri standart `tool_use` / `tool_result` kalıbını izler. MCP araçlarının eklenmesi veya kaldırılması tools dizisinin değişmesine neden olur ve önbellek yeniden oluşturmayı tetikleyebilir.

package/concepts/tr/Tools.md

@@ -0,0 +1,73 @@
+# Claude Code Araç Listesi
+
+Claude Code, Anthropic API'nin tool_use mekanizması aracılığıyla modele bir dizi yerleşik araç sunar. Her MainAgent isteğinin `tools` dizisi bu araçların tam JSON Schema tanımlarını içerir ve model yanıtında `tool_use` content block aracılığıyla bunları çağırır.
+
+Aşağıda tüm araçların kategorize edilmiş dizini bulunmaktadır.
+
+## Agent Sistemi
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Task](Tool-Task.md) | Karmaşık çok adımlı görevleri işlemek için alt agent (SubAgent) başlatma |
+| [TaskOutput](Tool-TaskOutput.md) | Arka plan görevinin çıktısını alma |
+| [TaskStop](Tool-TaskStop.md) | Çalışan arka plan görevini durdurma |
+| [TaskCreate](Tool-TaskCreate.md) | Yapılandırılmış görev listesi girdisi oluşturma |
+| [TaskGet](Tool-TaskGet.md) | Görev detaylarını alma |
+| [TaskUpdate](Tool-TaskUpdate.md) | Görev durumunu, bağımlılıkları vb. güncelleme |
+| [TaskList](Tool-TaskList.md) | Tüm görevleri listeleme |
+
+## Dosya İşlemleri
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Read](Tool-Read.md) | Dosya içeriğini okuma (metin, resim, PDF, Jupyter notebook desteği) |
+| [Edit](Tool-Edit.md) | Kesin dize değiştirme ile dosya düzenleme |
+| [Write](Tool-Write.md) | Dosya yazma veya üzerine yazma |
+| [NotebookEdit](Tool-NotebookEdit.md) | Jupyter notebook hücresini düzenleme |
+
+## Arama
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Glob](Tool-Glob.md) | Dosya adı kalıp eşleştirmesiyle dosya arama |
+| [Grep](Tool-Grep.md) | ripgrep tabanlı dosya içeriği arama |
+
+## Terminal
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Bash](Tool-Bash.md) | Shell komutu çalıştırma |
+
+## Web
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [WebFetch](Tool-WebFetch.md) | Web sayfası içeriğini çekme ve AI ile işleme |
+| [WebSearch](Tool-WebSearch.md) | Arama motoru sorgusu |
+
+## Planlama ve Etkileşim
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Planlama moduna girme, uygulama planı tasarlama |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Planlama modundan çıkma ve planı kullanıcı onayına sunma |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Açıklama veya karar almak için kullanıcıya soru sorma |
+
+## Eklentiler
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Skill](Tool-Skill.md) | Beceri (slash command) çalıştırma |
+
+## IDE Entegrasyonu
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [getDiagnostics](Tool-getDiagnostics.md) | VS Code dil tanılama bilgilerini alma |
+| [executeCode](Tool-executeCode.md) | Jupyter kernel'da kod çalıştırma |
+
+## cc-viewer'da Önemi
+
+Araç çağrıları, Claude Code istek günlüklerindeki en temel gözlemlenebilir verilerden biridir. Her MainAgent isteğinin `tools` dizisi modelin kullanabileceği araç setini tanımlar ve yanıttaki `tool_use` / `tool_result` content block'ları gerçek araç çağrılarını ve dönüşlerini kaydeder. cc-viewer bu verileri ayrıştırarak Chat Mode'da tam araç çağrı zincirini yeniden oluşturur.
+
+Araç tanımlarındaki değişiklikler (MCP server bağlantı/kopma nedeniyle araç ekleme/çıkarma gibi) önbellek yeniden oluşturmayı tetikler, detaylar için [CacheRebuild](CacheRebuild.md) belgesine bakın.

package/concepts/tr/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Translate API Bağlam Kirliliği
+
+## Arka Plan
+
+CC-Viewer, Anthropic Messages API tarafından desteklenen yerleşik bir çeviri özelliği (`POST /api/translate`) içerir. Erken uygulamada, çeviri istekleri Claude Code oturumundan önbelleğe alınmış kimlik doğrulama bilgilerini yeniden kullanıyordu — hem `x-api-key` hem de `authorization` başlıkları dahil. Bu, ince ama ciddi bir soruna neden oldu: çeviri sonuçları sıklıkla alakasız içerik döndürüyordu.
+
+## Temel Neden
+
+### İki Kimlik Doğrulama Yöntemi Arasındaki Temel Fark
+
+Anthropic API iki kimlik doğrulama yöntemini destekler:
+
+| Yöntem | Başlık | Tipik Kaynak | Özellikler |
+|--------|--------|--------------|------------|
+| API Anahtarı | `x-api-key: sk-ant-...` | Ortam değişkeni / Console | Durumsuz, her istek bağımsızdır |
+| OAuth Token | `authorization: Bearer sessionToken` | Claude Code abonelik girişi | Oturuma bağlı, sunucu bağlam ilişkilendirmesini sürdürür |
+
+Temel fark: **API Anahtarları durumsuz (stateless)** — her istek tamamen bağımsızdır; oysa **OAuth oturum tokenları durumlu (stateful)** — Anthropic sunucusu aynı tokeni kullanan istekleri aynı oturum bağlamıyla ilişkilendirir.
+
+### Kirlilik Zinciri
+
+Claude Code abonelik OAuth girişi kullandığında, kimlik doğrulama akışı şöyle görünür:
+
+```
+Claude Code ana konuşma ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                      ↑
+CC-Viewer çeviri isteği ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Çeviri istekleri aynı oturum tokenını yeniden kullandığından, Anthropic sunucusu çeviri isteklerini Claude Code'un ana konuşma bağlamıyla ilişkilendirebilir. Bu durum şunlara yol açar:
+
+1. **Çeviri sonuçları ana konuşma bağlamından etkilenir**: Çeviri isteğinin sistem promptu "sen bir çevirmensin" olmasına rağmen, sunucu bağlamı hâlâ Claude Code'un konuşma geçmişini içerir ve bu modeli potansiyel olarak etkileyebilir
+2. **Ana konuşma çeviri istekleri tarafından bozulur**: Çeviri isteği içeriği (UI metin parçaları) ana konuşma bağlamına enjekte edilebilir ve Claude Code'un yanıtlarının sapmasına neden olabilir
+3. **Öngörülemeyen davranış**: Bağlam kirliliği sunucu tarafı davranışı olduğundan, istemci bunu tespit edemez veya kontrol edemez
+
+## Çıkarılan Dersler
+
+- **OAuth oturum tokenları "sadece başka bir API Anahtarı" değildir** — sunucu tarafı durumu taşırlar, yeniden kullanmak bağlamı paylaşmak anlamına gelir
+- **Dahili servis çağrıları, kullanıcı oturumlarıyla ilişkilendirmeden kaçınmak için bağımsız, durumsuz kimlik doğrulama kullanmalıdır**
+
+## Referanslar
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/uk/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (Інкрементальне порівняння тіла запиту)
+
+## Передумови
+
+MainAgent Claude Code використовує механізм повного надсилання контексту — кожен запит містить повну історію розмови, system prompt, визначення інструментів тощо. Це означає, що в міру просування розмови тіло запиту стає дедалі більшим, і безпосередній перегляд необробленого Body ускладнює швидке визначення того, "що саме було додано в цьому раунді".
+
+Body Diff JSON створений саме для вирішення цієї проблеми: він автоматично порівнює тіла двох послідовних запитів MainAgent, витягує інкрементальну частину і дозволяє одразу побачити, що саме було додано в цьому запиті.
+
+## Принцип роботи
+
+1. **Ідентифікація послідовних запитів MainAgent**: Поточний запит повинен бути типу MainAgent, і повинен існувати попередній запит MainAgent
+2. **Порівняння по полях**: Переглядаються всі поля верхнього рівня тіла запиту, внутрішні властивості з префіксом `_` пропускаються
+3. **Інтелектуальне витягування різниць**:
+   - Додані поля: Відображаються безпосередньо
+   - Видалені поля: Не відображаються (зазвичай не впливають на розуміння)
+   - Змінені поля: Відображається поточне значення
+   - Масив `messages` обробляється спеціально: Показуються лише додані повідомлення (оскільки в нормальній розмові використовується режим додавання, префіксні повідомлення не змінюються)
+4. **Виявлення зменшення тіла запиту**: Якщо поточне тіло запиту менше за попереднє, це означає, що відбулося обрізання контексту або скидання сесії; в цьому випадку замість diff відображається інформаційне повідомлення
+
+## Типові сценарії
+
+У звичайному раунді розмови Body Diff JSON зазвичай містить лише:
+- `messages`: 1~2 додані повідомлення (введення користувача + відповідь асистента з попереднього раунду)
+
+Якщо ви бачите в diff зміни полів `system`, `tools`, `model`, це означає, що в цьому раунді відбулася зміна конфігурації, що зазвичай є причиною перебудови кешу.
+
+## Спосіб використання
+
+- Body Diff JSON відображається на панелі деталей запиту MainAgent
+- Натисніть на заголовок, щоб розгорнути/згорнути
+- Підтримуються два режими перегляду — JSON і Text, а також копіювання одним кліком
+- У лівому верхньому куті в **CC-Viewer → Глобальні налаштування** можна встановити "Розгортати Body Diff JSON за замовчуванням"