README.tr.md

⚡ ContextZip

Claude'un çıktısı gereksiz gürültüyle dolu.
ContextZip bunu %60-90 sıkıştırır. npx contextzip → 5 saniye (ilk çalıştırmada binary indirilir).

Kurulum • Before/After • Benchmark • English • 한국어 • 日本語 • 中文 • Español • Português • हिन्दी • Français • Deutsch • Русский • Türkçe • Tiếng Việt

---

  30 satır node_modules stack trace          →    3 satır
  150 satır npm deprecated uyarısı           →    3 satır
  50 satır Docker build hash'i               →    1 satır
  ANSI renkleri, spinner'lar, ilerleme çubuğu →   kaldırıldı

⬇️ Tek satır. Hepsi bu.

npx contextzip

Claude Code'u yeniden başlatın. Her komut otomatik sıkıştırılır. Sıfır yapılandırma.
macOS · Linux · Windows

Diğer kurulum yöntemleri

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/jee599/contextzip/main/install.sh | bash
brew install jee599/tap/contextzip

# Windows (PowerShell)
npx contextzip

# Rust geliştiricileri
cargo install --git https://github.com/jee599/contextzip

---

👀 Farkı Gör

💥 Node.js Hatası — 30 satır → 3 satır (%92 tasarruf)

❌ Before TypeError: Cannot read properties of undefined (reading 'id') at getUserProfile (users.ts:47) at processAuth (auth.ts:12) at Layer.handle (node_modules/ express/lib/router/layer.js:95) at next (node_modules/express/ lib/router/route.js:144) at Route.dispatch (node_modules/ express/lib/router/route.js:114) ... 25 more node_modules lines

✅ After TypeError: Cannot read properties of undefined (reading 'id') → users.ts:47 getUserProfile() → auth.ts:12 processAuth() (+ 27 framework frames hidden) 💾 saved 92%

📦 npm install — 150 satır → 3 satır (%58-95 tasarruf, uyarı sayısına göre değişir)

❌ Before npm warn deprecated inflight@1.0.6 npm warn deprecated rimraf@3.0.2 npm warn deprecated glob@7.2.3 npm warn deprecated bcrypt@3.0.0: security vulnerability CVE-2023-31484 ... 45 more deprecated warnings added 847 packages, audited 848 143 packages looking for funding run `npm fund` for details 8 vulnerabilities (2 moderate, 6 high) To address issues: npm audit fix ... 20 more lines

✅ After ✓ 847 packages (32s) ⚠ 8 vulnerabilities (6 high, 2 mod) ⚠ bcrypt@3.0.0: CVE-2023-31484 Güvenlik korundu. Gürültü temizlendi. 💾 saved 95%

🐳 Docker Build — 50 satır → 1 satır (%96 tasarruf)

❌ Before Step 1/12 : FROM node:20-alpine ---> abc123def456 Step 2/12 : WORKDIR /app ---> Using cache ---> 789ghi012jkl Step 3/12 : COPY package*.json ./ ---> Using cache ... 8 more steps with hashes Removing intermediate container xyz Successfully built abc123final Successfully tagged my-app:latest

✅ After ✓ built my-app:latest (12 steps, 8 cached) Güvenlik korundu. Gürültü temizlendi. 💾 saved 96%

🐍 Python Traceback — framework frame'leri gizlendi (%72 tasarruf)

❌ Before Traceback (most recent call last): File "/app/main.py", line 10, in handler process(data) File "/usr/lib/python3.11/ importlib/__init__.py", line 126 File "/app/venv/lib/site-packages/ flask/app.py", line 1498 File "/app/venv/lib/site-packages/ flask/app.py", line 1476 ValueError: invalid literal for int()

✅ After Traceback (most recent call last): → /app/main.py:10 process(data) (+ 3 framework frames hidden) ValueError: invalid literal for int() 💾 saved 72%

🦀 Rust Panic — std/tokio kaldırıldı (err filtresiyle %2-7 tasarruf)

❌ Before thread 'main' panicked at 'index out of bounds', src/handler.rs:42:5 stack backtrace: 0: std::panicking::begin_panic 1: core::panicking::panic_fmt 2: myapp::handler::process at ./src/handler.rs:42:5 3: myapp::main at ./src/main.rs:15:3 4: std::rt::lang_start 5: tokio::runtime::enter

✅ After thread 'main' panicked at 'index out of bounds', src/handler.rs:42:5 (+ 2 framework frames hidden) → handler.rs:42 process() → main.rs:15 main() (+ 2 framework frames hidden) 💾 saved 2-7% (err filtresi; Rust panic formatı henüz optimize edilmedi)

🔨 TypeScript Build — 40 hata gruplanmış (%81 tasarruf)

❌ Before src/api/users.ts:47:5 - error TS2322: Type 'string' not assignable to 'number' src/api/users.ts:83:5 - error TS2322: Type 'string' not assignable to 'number' src/api/orders.ts:12:5 - error TS2322: Type 'string' not assignable to 'number' src/api/orders.ts:45:5 - error TS2322: Type 'string' not assignable to 'number' ... 36 more identical errors Found 40 errors in 8 files.

✅ After TS2322: Type 'string' not assignable to type 'number' (×40) src/api/users.ts :47, :83 src/api/orders.ts :12, :45, :67 src/api/products.ts :23, :89 src/lib/helpers.ts :156 ... +4 files (28 occurrences) All line numbers preserved. 💾 saved 81%

🌐 Web Sayfası — nav/footer/reklamlar kaldırıldı (%73 tasarruf)

❌ Before (curl çıktısı) [Skip to content] [Nav: Products, Pricing, Docs, Blog] [Sidebar: Getting Started, Auth, Database, Storage, Functions] # Email/Password Authentication Use supabase.auth.signInWithPassword to sign in users... [code example] [code example] [Footer: © 2026 Supabase Inc] [Terms | Privacy | Status] [Newsletter: Subscribe for updates] [Social: Twitter GitHub Discord]

✅ After # Email/Password Authentication Use supabase.auth.signInWithPassword to sign in users... [code example] [code example] Nav, footer, sidebar, newsletter, sosyal bağlantılar — hepsi kaldırıldı. 💾 saved 73%

🎨 ANSI / Spinner — görünmez gürültü kaldırıldı (%83 tasarruf)

❌ Before (raw terminal) \033[32m✓ Success\033[0m \033[31m✗ Error\033[0m ⠋ Installing dependencies... ⠙ Installing dependencies... ⠹ Installing dependencies... ⠸ Installing dependencies... ████░░░░░░ 40% ████████░░ 80% ██████████ 100% ═══════════════════════ Done.

✅ After ✓ Success ✗ Error ██████████ 100% Done. Sadece son durumlar korundu. 💾 saved 83%

🐳 Docker hatası — bağlam korundu

✗ Docker build failed at step 7/12

Step 5/12 : COPY package*.json ./    (cached ✓)
Step 6/12 : RUN npm install          (cached ✓)
Step 7/12 : RUN npm run build        ← FAILED
  error: Module not found: 'react-dom/client'
  Exit code: 1

Başarısız adım + önceki 2 adım + hata mesajı + çıkış kodu. Her zaman.

☕ Java / 🐹 Go stack trace'leri

Java — java.lang.reflect, sun.reflect, org.springframework, org.apache, jdk.internal kaldırır:

- java.lang.NullPointerException: Cannot invoke method on null
-   at com.myapp.UserService.getUser(UserService.java:42)
-   at com.myapp.Controller.handle(Controller.java:15)
-   at java.lang.reflect.Method.invoke(Method.java:498)
-   at sun.reflect.DelegatingMethodAccessorImpl.invoke(...)
-   at org.springframework.web.servlet.FrameworkServlet.service(...)
-   at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(...)

+ java.lang.NullPointerException: Cannot invoke method on null
+   at com.myapp.UserService.getUser(UserService.java:42)
+   at com.myapp.Controller.handle(Controller.java:15)
+   (+ 4 framework frames hidden)

Go — runtime/, runtime.gopanic, runtime.main kaldırır:

- goroutine 1 [running]:
- runtime/debug.Stack()
-   /usr/local/go/src/runtime/debug/stack.go:24
- runtime.gopanic({0x1234, 0x5678})
-   /usr/local/go/src/runtime/panic.go:884
- main.handler()
-   /app/handler.go:42 +0x1a4
- main.main()
-   /app/main.go:15 +0x58

+ goroutine 1 [running]:
+   (+ 2 framework frames hidden)
+   → main.handler()  /app/handler.go:42
+   → main.main()     /app/main.go:15
+   (+ 1 framework frames hidden)

---

📊 Rakamlar Yalan Söylemez

102 gerçek test. Cherry-picking yok.

Kategori	Test	Ort. Tasarruf	🏆 En İyi	💀 En Kötü
🐳 Docker build	10	88%	97%	77%
🎨 ANSI/spinner	15	83%	98%	0%
💥 Hata izleri	20	59%	97%	-12%
🔨 Build hataları	15	56%	90%	-10%
🌐 Web sayfaları	15	43%	64%	5%
💻 CLI komutları	12	42%	99%	-56%
📦 Paket kurulumu	15	39%	99%	2%

Ağırlıklı toplam: %61 tasarruf → 326K chars in, 127K chars out

Note

Negatif = çıktı büyüdü. Çok küçük girdilerde olur. En kötü rakamları tabloya koyuyoruz çünkü gizlemek dürüst olmaz. Tam benchmark →

---

🏎️ Nasıl Çalışır

  ┌─────────────────────────────────────────────┐
  │  Claude Code runs: git status               │
  │                         ↓                   │
  │  Hook rewrites → contextzip git status      │
  │                         ↓                   │
  │  ┌──────────────────────────────────────┐   │
  │  │ [1] ANSI preprocessor    strip junk  │   │
  │  │ [2] Command router    40+ filters    │   │
  │  │ [3] Error post-proc   compress stack │   │
  │  │ [4] SQLite tracker    record savings │   │
  │  └──────────────────────────────────────┘   │
  │                         ↓                   │
  │  Compressed output → Claude's context       │
  │  💾 contextzip: 200 → 40 tokens (80%)       │
  └─────────────────────────────────────────────┘

---

🆚 Neden Sadece RTK Değil?

RTK (28k⭐) üzerine kurulu. RTK'nın 34 komutunun tamamı dahil. Ek olarak:

	RTK	ContextZip
CLI sıkıştırma (git, test, ls)	✅	✅
Hata stack trace'leri (Node/Python/Rust/Go/Java)	❌	✅
Web sayfası içerik çıkarma	❌	✅
ANSI / spinner / dekorasyon kaldırma	🟡	✅
Build hata gruplama (tsc/eslint/cargo)	🟡	✅
Paket kurulum gürültüsü (npm/pip/cargo)	❌	✅
Docker build sıkıştırma	🟡	✅
Komut başına tasarruf gösterimi	❌	✅

---

📈 Her Şeyi Takip Et

$ contextzip gain
📊 ContextZip Token Savings
════════════════════════════════════════
Total commands:    2,927
Tokens saved:      10.3M (89.2%)
Efficiency meter: █████████████████████░░░ 89%

$ contextzip gain --by-feature
Feature        Commands  Saved     Avg%
cli (RTK)      2,100     6.8M     78%
error          89        1.2M     93%
web            43        0.9M     73%
build          112       0.4M     81%
pkg            34        0.3M     95%
docker         22        0.2M     85%

--graph günlük grafik  •  --history son komutlar

---

🛡️ Önemli Hiçbir Şey Kaybolmaz

🔴 Hata mesajları	HER ZAMAN korunur
📍 Build hatalarında dosya:satır	ASLA kaldırılmaz
🔒 Güvenlik uyarıları (CVE, GHSA)	HER ZAMAN tutulur
🐳 Docker hata bağlamı	HER ZAMAN korunur
⏎ Çıkış kodları	HER ZAMAN iletilir

Important

ContextZip yalnızca doğrulanmış gürültüyü kaldırır. Şüphe durumunda → passthrough.

---

🔧 Komutlar

# Otomatik (hook dönüştürür — önek gerekmez):
git status              npm install             cargo test
docker build .          pip install flask        go test ./...

# Manuel:
contextzip web https://docs.example.com    # sayfa → yalnızca içerik
contextzip err node server.js              # hata odaklı çıktı

# Analitik:
contextzip gain                  # gösterge paneli
contextzip gain --by-feature     # filtre başına istatistik
contextzip gain --graph          # günlük grafik
contextzip gain --history        # son komutlar

# Yönetim:
contextzip init --show           # kurulumu kontrol et
contextzip update                # kendini güncelle
contextzip uninstall             # temiz kaldırma

---

🤝 Katkıda Bulun

git clone https://github.com/jee599/contextzip.git && cd contextzip
cargo test         # 1,056 tests
cargo clippy       # lint

📡 Telemetri

ContextZip, aracı iyileştirmek için anonim kullanım istatistikleri (komut sayısı, tasarruf yüzdesi) toplar. Kişisel veri veya komut içeriği iletilmez.

Devre dışı bırak:

export CONTEXTZIP_TELEMETRY_DISABLED=1
# veya ~/.config/contextzip/config.toml dosyasında:
# [telemetry]
# enabled = false

📜 Lisans

MIT — rtk-ai tarafından geliştirilen RTK'nın fork'u.

---

⚡ Daha az gürültü. Daha çok kod. Daha hızlı deploy.