claude-keeper

Claude Code için otomatik seans penceresi yönetimi. İzleme maliyeti: sıfır token.

🇬🇧 English

Claude Code abonelik kullanımı, 5 saatlik kayan pencerelerle ölçülür — ve yeni pencere ancak siz mesaj gönderince başlar. Pencerenin sıfırlanması ile bir sonraki mesajınız arasındaki her dakika, parasını ödediğiniz ama hiç kullanmadığınız kapasitedir. claude-keeper bu boşluğu kapatır: pencereyi yerel olarak takip eder ve öncekinin süresi dolduğu anda yenisini açar.

keeper'sız   ████ çalışma ████ · · boşta · · |———— reset ————| · · · uzaktasınız, pencere işlemiyor · · ·
keeper'lı    ████ çalışma ████ · · boşta · · |———— reset ————|████ yeni pencere çoktan açık

Öne çıkanlar

• Sıfır maliyetli izleme — pencere durumu Claude Code'un yerel JSONL loglarından (~/.claude/projects/) hesaplanır. API çağrısı yok, token yok, kontrol başına ~50ms.
• Uyandırmada minimum iz — yeni pencere başına tam olarak bir kısa, özelleştirilebilir mesaj. Başka hiçbir şey gönderilmez.
• Sıfır bağımlılık — saf Node.js. macOS, Linux ve Windows'ta birebir aynı davranış.
• Dayanıklı — yerel log yoksa claude -p "/usage" çıktısına düşer; durumu belirleyemediğinde ise körlemesine mesaj atmak yerine hiçbir şey yapmaz.

Kurulum

npm install -g claude-keeper

Node.js ≥ 18.3 ve oturum açılmış bir Claude Code CLI gerektirir.

Kullanım

claude-keeper start --daemon                  # arka planda çalıştır — terminali kapat, çalışmaya devam eder
claude-keeper status                          # daemon çalışıyor mu?
claude-keeper logs                            # son daemon aktivitesi
claude-keeper stop                            # daemon'u durdur

claude-keeper start                           # veya ön planda çalıştır
claude-keeper start --interval 10             # özel kontrol aralığı (dakika)
claude-keeper start --message "Yeni seans"    # özel uyandırma mesajı
claude-keeper check                           # tek seferlik durum raporu

Daemon durumu ~/.claude-keeper/ altında tutulur (pid + log dosyası). Daemon yeniden başlatmadan sonra hayatta kalmaz — makinenizi yeniden başlatınca tekrar başlatın.

Nasıl çalışır?

1. Her kontrolde, mevcut 5 saatlik blok Claude Code'un yerel mesaj loglarından hesaplanır — ccusage'ın kullandığı tekniğin aynısı.
2. Yerel log yoksa claude -p "/usage" çıktısı yorumlanır. Tanınmayan çıktı unknown sayılır — keeper uyarı loglar ve körlemesine mesaj atmak yerine hiçbir şey yapmaz.
3. Blok süresi dolduğunda claude -p "<mesaj>" bir kez çalıştırılır. Yeni pencere başlar, izleme devam eder.

Seans pencereleri hesap genelinde geçerlidir; claude-keeper herhangi bir dizinden çalıştırılabilir.

Lisans

MIT