Tokenectomy Razor

Tokenectomy Razor

Claude Code ve Cursor Hız Sınırlarını Düzeltin: Rust ile Yazılmış Sıfır Gecikmeli Yerel AI Ağ Geçidi ve Bağlam Cerrahisi MCP Sunucusu

node_modules yığın izlerinde 20.000 token yakmayı bırakın. Tokenectomy Razor, güvenli Rust ile yazılmış, milisaniyenin altında çalışan yerel bir AI Ağ Geçidi ters proxy'si (127.0.0.1:8080) ve beraberindeki MCP sunucusudur. Terminal hata günlüklerindeki çerçeve gürültüsünün %41,7–%99,7'sini keser, sızan veritabanı kimlik bilgilerini/JWT'leri karartır ve istemleri ücretsiz olarak önbelleğe alır.

Hızlı Başlangıç (10 sn) • Mimari • Sorun • Öncesi ve Sonrası • Canlı Etkileşimli Demo • Kıyaslamalar

                                 ┌────────────────────────────────────────────────────────┐
                                 │                   Autonomous Agents                    │
                                 │  Claude Code • Cursor • Antigravity • Cline • Windsurf │
                                 └───────────────────────────┬────────────────────────────┘
                                                             │
                                                             ▼ (HTTP / SSE Outbound Prompts)
   ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
   │                                 ⚡ TOKENECTOMY AI GATEWAY (127.0.0.1:8080)                                       │
   │                                                                                                                  │
   │  ┌─────────────────────────┐   ┌───────────────────────────┐   ┌──────────────────────────────────────────────┐  │
   │  │   Zero-Cost Prompt      │   │   Zero-Leak Credential    │   │         Polyglot Trace Surgery               │  │
   │  │         Cache           │   │         Redaction         │   │            (9 Languages)                     │  │
   │  │  <1ms Hit • 100% Free   │   │  API Keys • JWTs • DB URIs│   │  node_modules • site-packages • .cargo       │  │
   │  └───────────┬─────────────┘   └─────────────┬─────────────┘   └──────────────────────┬───────────────────────┘  │
   │              │                               │                                        │                          │
   │              └───────────────────────────────┼────────────────────────────────────────┘                          │
   │                                              ▼                                                                   │
   │                                 Smart Upstream Auto-Router                                                       │
   │                         (Anthropic • OpenAI • Groq • Ollama Local)                                               │
   └──────────────────────────────────────────────┬───────────────────────────────────────────────────────────────────┘
                                                  │
                 ┌────────────────────────────────┼────────────────────────────────┐
                 ▼                                ▼                                ▼
       api.anthropic.com                  api.openai.com                   localhost:11434
    (Claude 3.5 / 3.7 Sonnet)         (GPT-4o / o1 / o3-mini)              (DeepSeek / Llama)

⚡ Hızlı Başlangıç (10 sn)

0. Sıfır Yapılandırmalı Tek Satırlık Sarmalayıcı (wrap)

Herhangi bir kodlama aracısını veya test paketini, manuel ortam değişkeni kurulumu olmadan doğrudan Tokenectomy'nin gizlilik ve önbellekleme ağ geçidinin arkasında çalıştırın:

# Wrap Claude Code CLI
razor wrap -- claude

# Wrap Aider with DeepSeek or Ollama (Auto-Transpiled on the fly!)
razor wrap -- aider --model deepseek/deepseek-chat

# Wrap test runs to scrub logs and prevent accidental credential leakage
razor wrap npm test

1. Bağımsız AI Ağ Geçidini Başlatın (Manuel Mod)

npx -y tokenectomy-razor --proxy

💡 Akıllı Çoklu Sağlayıcı Otomatik Yönlendirme ve Evrensel LLM Dönüştürücü varsayılan olarak AÇIK! Tokenectomy, istek yollarını ve başlıklarını otomatik olarak analiz eder. Claude Code'u DeepSeek veya Ollama'ya karşı mı çalıştırmanız gerekiyor? Tokenectomy, Anthropic /v1/messages biçimini anında OpenAI /v1/chat/completions biçimine ve tam tersine şeffaf bir şekilde dönüştürür.

2. Favori Aracınızı Bağlayın

Kodlama aracınızı veya CLI'nizi 127.0.0.1:8080 adresindeki yerel ağ geçidine yönlendirin:

3. Gerçek Zamanlı FinOps ve Güvenlik Panosu

Tarayıcınızda http://127.0.0.1:8080/dashboard adresini açarak canlı token azaltmalarını, istem önbellek isabetlerini, dolar tasarruflarını ve karartılmış kimlik bilgilerini gerçek zamanlı olarak gözlemleyin.

4. Beraberindeki MCP Sunucusu Kurulumu (Alt Korteks)

Derin tanılama araçlarını çağıran aracılar için (get_error_context, analyze_code, apply_code_patch):

Claude Code CLI

claude mcp add tokenectomy npx -y tokenectomy-razor --mcp

Google Antigravity / Gemini CLI

agy mcp add tokenectomy-razor -- npx -y tokenectomy-razor --mcp

Cursor Composer (.cursor/mcp.json)

{
  "mcpServers": {
    "tokenectomy": {
      "command": "npx",
      "args": ["-y", "tokenectomy-razor", "--mcp"]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tokenectomy": {
      "command": "npx",
      "args": ["-y", "tokenectomy-razor", "--mcp"]
    }
  }
}

5. Terminal Boru Hattı ve CLI Temizleme

npm test 2>&1 | npx tokenectomy-razor

🛑 Sorun: AI'nız Neden Hız Sınırlarına Takılıyor ve Halüsinasyon Görüyor

Uygulamanız geliştirme sırasında çöktüğünde (Next.js, Express, FastAPI, Tokio), çalışma zamanı node_modules veya site-packages kaynaklı yüzlerce satır üçüncü taraf tesisatını döker.

Bu ham çökme dökümünü Cursor veya Claude'a yapıştırdığınızda:

1. 5 Saatlik Hız Sınırınızı Tüketir: Tek bir Express/Prisma hatası, hiç yazmadığınız 5.000 ila 45.000 token üçüncü taraf kitaplık kodu dökebilir. Birkaç çökme döngüsü oturum limitinizi kolayca tüketir.
2. AI Halüsinasyonlarını Tetikler: Claude, çerçeve iç işleyişinde (node_modules/express/lib/router/layer.js veya starlette/routing.py) kaybolur ve gerçek uygulama kodunuz yerine kitaplık dosyalarını düzenlemeye çalışır.
3. Sırları ve Kimlik Bilgilerini Sızdırır: Hata izlerine gömülü ham veritabanı parolaları, JWT taşıyıcı token'ları ve bulut anahtarları içeren bağlantı dizeleri harici model sunucularına iletilir.

Raw Terminal Crash (45,820 tokens + Leaked Secrets)
     │
     ▼  <0.2ms Local Rust DFA Engine
[Redact Passwords & Keys] ──► [Strip Third-Party Framework Frames] ──► [Isolate Root Cause]
     │
     ▼
Clean Context (118 tokens • Zero Secrets • Sub-millisecond)

🔍 Öncesi ve Sonrası Karşılaştırması

❌ Tokenectomy Olmadan: AI Halüsinasyon Görür ve Bağlamı Tüketir

TypeError: Cannot read properties of undefined (reading 'token')
    at loadComponents (/app/node_modules/next/dist/server/load-components.js:14:2)
    at renderToHTML (/app/node_modules/next/dist/server/render.js:50:5)
    at nextServer (/app/node_modules/next/dist/server/next-server.js:80:12)
    at processTicksAndRejections (node:internal/process/task_queues:95:5)
    at runMicrotasks (node:internal/process/task_queues:120:3)
    at checkoutHandler (/app/pages/api/checkout.ts:42:15)
Database connection failed: postgresql://admin:super_secret_password@db.prod.internal:5432/primary
API key leaked: sk-ant-api03-abcdef1234567890abcdef1234567890

Claude'un yaptığı: load-components.js ve next-server.js analiz eder, Webpack / Next.js iç işleyişi hakkında spekülasyon yapar ve bağlantı kimlik bilgilerini uzak çıkarım günlüklerine sızdırır.

✅ Tokenectomy ile: Temiz Bağlam ve Anında Düzeltme

// [Tokenectomy Surgery: 5 internal framework frames pruned (83.3%)]
// Source: /app/pages/api/checkout.ts:42:15
42 |   const sessionToken = req.headers.authorization.token;
   |                                                  ^ TypeError: Cannot read properties of undefined (reading 'token')
🛡️ [CONNECTION_STRING_REDACTED]
🛡️ [ANTHROPIC_KEY_REDACTED]

Claude'un yaptığı: checkout.ts dosyasındaki 42. satırın tanımsız başlıklarda .token öğesine erişmeye çalıştığını anında belirler. Hemen isteğe bağlı zincirleme req.headers.authorization?.token önerir. Kimlik bilgileri iletimden önce karartılır.

🔬 Doğrulanabilir Kıyaslamalar

Tüm performans iddiaları donanıma dayalıdır ve fiziksel donanım üzerinde bağımsız olarak yeniden üretilebilir (Arch Linux, Kernel 6.13 çalıştıran 10 Çekirdekli Intel Core i5-1235U @ 15W üzerinde ölçülmüştür):

Donanım Bağımlılığı Bildirimi: Performans donanıma bağlıdır; bildirilen verim, belirtilen test donanımı (10 Çekirdekli Intel Core i5-1235U @ 15W TDP) üzerinde ölçülen sonuçları temsil eder. Verim, daha yüksek TDP'li masaüstü/sunucu CPU'ları ve daha hızlı bellek veri yollarıyla ölçeklenir. Geliştiricilerin, aşağıdaki yeniden üretim komutunu kullanarak performansı bağımsız olarak denetlemeleri önerilir.

$ cargo test --release --test stress_benchmark -- --nocapture

=====================================================================================
🧪 TOKENECTOMY OSS VERIFIABLE HEAVY STRESS BENCHMARK (100% REPRODUCIBLE IN OSS)
   Hardware: 10-Core / 12-Thread Intel Core i5-1235U | OS: Arch Linux | Kernel Telemetry Active
   Initial Baseline Process Memory (VmRSS): 3.45 MB
=====================================================================================

🔥 [TEST 1/3] QUARTER-MILLION LINES LOG REDACTION TORTURE (250,000 LINES / 25MB+ BUFFER)
  ├── Buffer Size: 24.44 MB (250000 lines)
  ├── Redaction Latency: 471.05ms (51.9 MB/sec)
  ├── Line Throughput: 530,735 lines/sec
  ├── Peak Memory (VmRSS): 76.05 MB (Delta: +72.60 MB)
  └── Status: ✅ PASSED (100% of 250,000 lines sanitized, zero memory balloon)

🔥 [TEST 2/3] REDOS CATASTROPHIC BACKTRACKING TORTURE (50,000 CHARS PAYLOAD)
  ├── Attack Payload Size: 50,082 characters
  ├── Execution Latency: 1.165 ms
  └── Status: ✅ PASSED (Linear O(N) evaluation, ReDoS-resistant on tested payloads)

🔥 [TEST 3/3] HIGH-CONCURRENCY TORTURE (100 PARALLEL OS THREADS)
  ├── Thread Concurrency: 100 concurrent OS threads
  ├── Successful Operations: 100/100 (100.0%)
  ├── Total Elapsed: 11.31ms
  ├── Concurrency Throughput: 17,688 ops/sec
  ├── Final VmRSS: 78.99 MB
  └── Status: ✅ PASSED (Zero race condition, zero deadlock)

=====================================================================================
🏆 TOKENECTOMY OSS STRESS BENCHMARK: 3/3 PASSED (100% GREEN)
   Total Suite Duration: 580.83ms
   Bounded Final VmRSS: 78.99 MB
=====================================================================================
test test_oss_heavy_stress_benchmark ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.58s

🛡️ Otomatik Karartma ve Gizli Bilgi Temizleme Kıyaslaması

22 temel doğruluk kimlik bilgisi ve temiz negatif kontroller içeren 12 çok dilli çökme izinden (Rust, Python, TypeScript, Go, YAML) oluşan dahili bir kıyaslama test fikstürü (tests/fixtures/) üzerinde değerlendirildi. Gitleaks v8.30.1 (varsayılan kural seti) ile karşılıklı olarak değerlendirildi.

Mimari Not: Gitleaks öncelikle bir depo commit/diff tarayıcısı olarak tasarlanmıştır, bellek içi çalışma zamanı iz karartıcı değildir. Tokenectomy Razor, özellikle çalışma zamanı akış temizleme ve yığın izi cerrahisi için tasarlanmıştır.

1. Kategori Bazında Hassasiyet, Geri Çağırma ve F1 Puanı

2. Karşılıklı Performans ve Mimari Özeti

3. Token Azaltma ve LLM Bağlam Tasarrufu (tiktoken cl100k_base)

🔌 Gelişmiş Aracı ve Ağ Geçidi Yapılandırması

1. Çoklu Sağlayıcılı AI Ağ Geçidi Seçenekleri (--proxy)

Tokenectomy'nin ağ geçidi, sıfır manuel yapılandırmayla 127.0.0.1:8080 adresinde yerel olarak çalışır. Karmaşık geliştirme ortamlarında veya kapsayıcılı aracı topolojilerinde bağlama ve yönlendirmeyi özelleştirebilirsiniz:

# Default Smart Auto-Routing (routes Anthropic, OpenAI, and Ollama requests dynamically):
razor --proxy

# Safety Circuit Breaker: Prevent runaway agent loops from burning your hourly budget or 5-hour window:
razor --proxy --max-hourly-tokens 200000

# Resilient 429 Auto-Retry: Automatically pause and retry when hitting upstream rate limits (default: on):
razor --proxy --max-retries 5

# Explicit upstream override (e.g. Groq, vLLM, or OpenRouter):
razor --proxy --upstream-url https://api.groq.com/openai/v1

# Secure remote container binding with mandatory bearer token:
razor --proxy --proxy-bind 0.0.0.0:8080 --allow-remote --proxy-token "$MY_GATEWAY_TOKEN"

Gerçek Zamanlı Metrikler ve Prometheus Dışa Aktarımı

Tokenectomy, JSON aracılığıyla canlı FinOps ve token ekonomisi verilerini sunar:

curl http://127.0.0.1:8080/v1/metrics

rate_limits_mitigated, circuit_breaker_trips, last_latency_ms, current_hourly_tokens, cache_hits, cache_tokens_saved ve estimated_cost_saved_usd için anlık telemetri döndürür.

2. Bağımsız CLI ve Terminal Temizleme

Terminal test çıktısını doğrudan hata ayıklarken veya boru hattına aktarırken:

# Pipe terminal test failures through the surgical redactor:
npm test 2>&1 | razor --scrub

# Sanitize a specific raw log file:
razor --scrub --file /var/log/app/error.log > sanitized.log

# Offline local air-gapped mode (zero external network calls):
cat failure.log | razor --scrub --local-only

🛠️ Sunulan MCP Araçları

Tokenectomy Razor, açık parametre sınırlarıyla Glama Grade A Tool Definition Quality Score (TDQS) standardına uygundur:

🌐 Desteklenen Çok Dilli Ekosistemler

📦 Kurulum Seçenekleri

Yöntem 1: npx ile Anında Kurulum (Sıfır Araç Zinciri Kurulumu)

npx -y tokenectomy-razor --mcp

Yöntem 2: Cargo (crates.io)

cargo install tokenectomy

Yöntem 3: Önceden Derlenmiş Bağımsız İkili Dosyalar

GitHub Releases üzerinde sıfır bağımlılıklı, bağımsız sürüm ikili dosyaları mevcuttur:

• Linux: x86_64-unknown-linux-gnu, x86_64-unknown-linux-musl, aarch64-unknown-linux-gnu
• macOS: aarch64-apple-darwin (Apple Silicon M1/M2/M3/M4), x86_64-apple-darwin (Intel)
• Windows: x86_64-pc-windows-msvc.exe

Yöntem 4: Çok Mimarili Docker Konteyneri (GHCR)

docker pull ghcr.io/tokenectomy-labs/razor:latest
docker run -i ghcr.io/tokenectomy-labs/razor:latest --mcp

⚖️ Sürüm Karşılaştırması

Kurumsal AST Kendi Kendini İyileştirme mi Gerekiyor? Sentinel Katmanını Keşfedin

🗺️ Yol Haritası ve Kilometre Taşları

🔒 Güvenlik ve Değişmezler

• Varsayılan Olarak Yerel Yürütme: Tüm yığın izi ayrıştırma, çerçeve budama ve gizli bilgi karartma işlemleri fiziksel donanımda yerel olarak gerçekleştirilir.
• Belgelenmiş Ağ Çıkışı: MCP sunucu modunda, search_stack_overflow dış ağ çıkışına sahip tek araçtır (api.stackexchange.com adresine HTTPS). Yük, yalnızca temizlenmiş, karartılmış hata imzası metniyle sınırlıdır (kod satırı yok, yerel yol yok, sıfır kimlik bilgisi). Hava boşluklu ortamlarda, ağ aramasını tamamen devre dışı bırakmak için --local-only kullanın.
• Deterministik Doğrusal Zamanlı Desen Eşleştirme: Tüm desen eşleştiriciler, geri izlemeyen DFA regex motorlarını ($O(N)$ doğrusal zaman) ve Aho-Corasick otomat değerlendirmesini kullanır.
• Yol Geçişi Sınır Yalıtımı: Dosya işlemleri, etkin çalışma alanı köküyle (CWD) sıkı bir şekilde sınırlandırılmıştır. Yol geçişleri (../) ve yetkisiz sembolik bağlantılar engellenir.
• Güvenli Rust Uygulaması: Çekirdek yürütme yolları, kaynak tükenmesini önleyen sınırlı akış okuyucularıyla (.take()) güvenli Rust bellek garantilerini uygular.

Güvenlik açığı bildirimleri için lütfen Güvenlik Politikamızı inceleyin.

⚖️ Yasal ve Alt Dal Feragatnamesi

Tokenectomy Razor, yalnızca yasal geliştirici üretkenliği, gözlemlenebilirlik, günlük cerrahisi ve savunma amaçlı kimlik bilgisi karartma için sağlanmıştır. Herhangi bir alt dal, klon, yeniden dağıtım veya özel dağıtım, orijinal yazarlardan tamamen bağımsız olarak çalışır. Tokenectomy Labs ve bakımcıları, bu kod tabanını veya türevlerini kullanan üçüncü taraflarca işlenen yasadışı, kötü niyetli veya yetkisiz eylemler için sıfır sorumluluk üstlenir. Tüm alt dal operatörleri, yerel ve uluslararası siber güvenlik yasalarına uyum konusunda %100 bireysel sorumluluk taşır. Tam yasal koşullar için DISCLAIMER.md dosyasına bakın.

❓ Sıkça Sorulan Sorular (SSS)

Tokenectomy Razor, Claude Code ve Cursor'ın hız sınırlarına takılmasını nasıl önler?

Testler veya terminal derlemeleri çöktüğünde, Next.js, Express, Jest ve Django gibi çerçeveler binlerce dahili yığın çerçevesi döker (node_modules, site-packages). Ham 5.000 satırlık çökme günlüklerinin gönderilmesi, istem başına 15.000 ila 45.000 token tüketir ve 5 saatlik oturum limitinizi dakikalar içinde tüketir. Tokenectomy Razor, günlükleri yakalar ve eyleme dönüştürülebilir olmayan çerçeve boru hattının %95'ini kaldırarak 40.000 karakterlik bir çökme günlüğünü <0,2ms içinde 200 temel tokenin altına indirir.

Cursor'ın node_modules hata günlüklerini LLM'lere göndermesini nasıl durdurabilirim?

Tokenectomy Razor'ı yerel bir AI Ağ Geçidi ters vekili olarak çalıştırın (npx -y tokenectomy-razor --proxy). Cursor ayarlarında, OpenAI Temel URL'nizi http://127.0.0.1:8080/v1 adresine yönlendirin. Composer tarafından yapıştırılan veya başvurulan herhangi bir terminal hata çıktısı, model sunucularına ulaşmadan önce otomatik olarak temizlenir, karartılır ve anında önbelleğe alınır.

Tokenectomy, hata günlüklerinde kimlik bilgisi sızıntısını nasıl önler?

Tüm günlük cerrahisi ve gizli bilgi karartma, dışa aktarımdan önce makinenizde %100 yerel olarak bellekte gerçekleştirilir. Razor, PostgreSQL/MongoDB bağlantı URI'lerini, JWT taşıyıcı belirteçlerini ve bulut API anahtarlarını [REDACTED] tokenleriyle tespit etmek ve karartmak için deterministik doğrusal zamanlı regex ve Aho-Corasick otomatlarını kullanır. Karartma için sıfır bulut çıkışı gerekir.

🤝 Topluluk ve Kaynaklar

• 🌐 Resmi Web Sitesi
• 📖 Dokümantasyon
• 🏗️ Sistem Mimarisi
• 📋 Değişiklik Günlüğü
• 🤝 Katkıda Bulunma Rehberi
• 🔒 Güvenlik Politikası
• ⚖️ Feragatname ve Sorumluluk