Açık kaynak Gauge CLI, sürtünme noktalarını bulmak için kodlama agent'larınızı dokümanlarınız üzerinde çalıştırıyor

gauge-sh projesinden yeni bir açık kaynak komut satırı aracı olan Gauge, 5 Kasım 2026'da Hacker News'te ortaya çıktı ve birçok geliştiricinin artık fark ettiği bir boşluğu hedefliyor: ürünleri yalnızca insanlar için değil, kodlama agent'ları için de kullanılabilir kılmak. Projenin GitHub deposuna göre Gauge, gerçek agent oturumlarını dokümanlarınız, CLI'larınız, SDK'larınız, MCP sunucularınız veya agent Skill'leriniz üzerinde çalıştırıyor, agent'ların zorlandığı yerleri kaydediyor ve ardından siz bir şey yayınlamadan önce kendi kodlama agent'ınızın aday düzeltmeleri test etmesine izin veriyor.

Agent kullanılabilirliği için bir ölçüm döngüsü

Proje yöntemini hillclimbing (tepe tırmanışı) olarak tanımlıyor: bir şeyi değiştir, değişikliğin yardımcı olup olmadığını ölç ve yinele. Döngü aşamalar halinde çalışıyor. Önce gerçekçi görevleri eval veya tercih prompt'ları olarak tanımlıyorsunuz; her birinin kararlı bir kimliği ve gözlemlenebilir başarı kriterleri var. Gauge ardından taze Docker sandbox'ları başlatıyor, yapılandırılmış girdilerinizin working-tree sürümünü enjekte ediyor ve her görevi gerçek bir agent ile çalıştırıyor. Sonrasında oturum kanıtları incelenerek görevi yavaşlatan veya engelleyen şeyler tespit ediliyor; siz veya agent'ınız ürünü veya rehberini düzenliyor ve sürtünmenin yeni sorunlar yaratmadan kaybolup kaybolmadığını görmek için etkilenen vakalar yeniden çalıştırılıyor.

Gauge şu anda dört agent harness'i destekliyor: Claude Code, Codex, Pi ve OpenCode; bunlar ya yerel girişlerle ya da API anahtarlarıyla kullanılabiliyor. Agent kullanımı, mevcut sağlayıcınız veya aboneliğiniz üzerinden faturalandırılıyor. Araç, dört harness'in olaylarını tutarlı transcript'lere dönüştürüyor ve bu da agent'lar arası karşılaştırmaları mümkün kılıyor.

Ortaya çıkardığı sorun türleri

Depo, gerçek oturumlardan tipik bulguları listeliyor:

• etkileşimli bir komut, asla gelmeyecek bir girdiyi bekleyen bir agent'ı durduruyor
• bir agent kullanımdan kalkmış komutlara veya güncelliğini yitirmiş API kalıplarına uzanıyor
• bir Skill, göreve yardımcı olacağı halde kullanılmadan duruyor
• bir agent, var olmayan bir kısıtlamadan kendinden emin bir şekilde söz ediyor
• bir agent, birden fazla komuta yayılan amaçlanan bir iş akışını bir araya getiremiyor

Doğru düzeltme hata mesajlarında, yardım metninde, dokümantasyonda, Skill içeriğinde veya kodun kendisinde olabilir. Bir npm CLI veya SDK için bir tarball oluşturup paketliyorsunuz ve Gauge bu ön sürüm artefaktını test oturumlarının içine kuruyor; böylece bir düzeltme gönderilmeden önce doğrulanabiliyor.

Local-first kurulum

Yerel mod için Node.js 22.13 veya üzeri, Linux container'ları çalıştıran Docker ve test edilen agent'ın kimlik bilgileri gerekiyor. Kurulum, @withgauge/cli için global bir npm install'dan oluşuyor; ardından CLI sürümünüze sabitlenmiş, agent harness'lerini ve yaygın geliştirme araçlarını içeren bir Docker imajını çeken bir komut geliyor.

Bir projeyi başlatmak, ölçümlerin ve analizlerin bulunduğu bir SQLite veritabanı barındıran özel bir .gauge/ workspace'i oluşturuyor; düz bir init izlenen hiçbir dosyaya dokunmuyor. İsteğe bağlı bir --cases bayrağı, paylaşılabilir dosyalar ekliyor — bir gauge.json manifest'i, bir gauge-cases/ dizini ve AGENTS.md'ye eklenen rehber — projeye göre bunlar ekip arkadaşları ve CI kullanımı için commit edilmeli.

Yerel modda analiz işi kendi kodlama agent'ınıza düşüyor: transcript'leri okuyor, her kriteri değerlendiriyor ve yapılandırılmış bulguları bir CLI komutuyla yayınlıyor. Ardından bir compare komutu, bir referans parti ile bir aday parti arasındaki tamamlama oranlarını, tur sayılarını, süreyi ve kriter kararlarını özetliyor; böylece bir düzenlemenin gerçekten yardımcı olup olmadığını görebiliyorsunuz. Bunların hiçbiri için Gauge hesabı gerekmiyor. Ücretli karşılığı olan Hosted Gauge ise ayrıca girdi olarak dokümanları, kimlik doğrulamalı MCP'leri ve kimlik doğrulamalı API'leri destekliyor ve oturum analizini otomatik olarak gerçekleştiriyor.

Neden önemli

Kodlama agent'ları yazılıma erişimin temel arayüzü haline geliyor ve bir agent'ın doğru komutu bulabilmesi, bir hata mesajını anlayabilmesi veya amaçlanan bir iş akışını çıkarabilmesi, bir ürünün hiç kullanılıp kullanılmayacağını giderek daha fazla belirliyor. İnsan odaklı dokümantasyon incelemesi bunların hiçbirini yakalayamıyor. Gauge'ün bahsi, agent'ların agent'lar için test yapabileceği yönünde: oturumu çalıştır, sürtünmeyi ölç, artefakt üzerinde yinele. Döngüyü açık kaynak yaparak ve Docker ile mevcut agent abonelikleriyle yerel olarak çalıştırılabilir tutarak proje, son değişikliklerinin Claude Code veya Codex için gerçekten işleri kolaylaştırdığına dair sezgi değil kanıt isteyen CLI, SDK ve dokümantasyon geliştiricileri için engeli düşürüyor. Agent deneyimi testi CI kadar rutin hale gelecek mi hâlâ açık bir soru, ama Gauge bu iş akışını uçtan uca ürüne dönüştürmek için erken bir deneme.