Ctxdiff: LLM Ajanları İçin Git Diff Tarzı Bağlam Hata Ayıklayıcı

Ctxdiff, LLM ajanlarının context window'unu tur tur incelemeyi sağlayan yerel çalışan bir hata ayıklama aracı. Tek satırlık bir wrapper ile OpenAI, Anthropic, Gemini, Bedrock veya LangChain/LangGraph istemcilerini sarmalayıp her çağrının tam bağlamını içerik-hash'li, tekilleştirilmiş bloklar halinde tek dosyalık bir SQLite .ctrace'e kaydediyor. Amaç, klasik gözlemlenebilirlik platformlarının cevaplayamadığı soruyu çözmek: bir ajan 8. turda neden bozuldu, model tam olarak ne gördü ve bu neye mal oldu.

Araç; git tarzı tur-tur diff, token dağılımı ve şema şişkinliği tespiti, prompt-cache önekini bozan karakteri bulan profil çıkarma, %80 eşiğinde uyaran bağlam penceresi doluluk oranı ve unutulan RAG bloklarını işaretleyen etiketleme gibi özellikler sunuyor. CI entegrasyonu, bağlam bütçesini pull request'lerde otomatik denetleyerek regresyonları erken yakalıyor; MCP sunucusu ise Claude Code veya Cursor gibi kodlama ajanlarının izleri doğrudan sorgulamasına imkan tanıyor.

LangSmith, Langfuse veya Phoenix gibi platformlar filo genelinde çağrıların anlık görüntüsünü sunarken, Ctxdiff tek bir çalıştırmanın turlar arasındaki farkına odaklanıyor. Veriler makineden hiç çıkmıyor, varsayılan depolama yerel dosya ama PostgreSQL/MySQL gibi arka uçlara da bağlanabiliyor. Python ve JavaScript/TypeScript SDK'ları aynı .ctrace formatını üretiyor, dolayısıyla bir dilde alınan iz diğerinin görüntüleyicisinde açılabiliyor.