İçeriğe geç
← Defter

usage-tracker

Çağır

Geliştirici aracı · Linux ● Aktif

usage-tracker AI Kullanım Paneli

Bütün yapay zekâ kullanımını tek panelde toplar: gerçek harcama, model kırılımı, canlı Claude limitleri. Bağımlılık yok; her şey kendi makinende kalır.

GitHub'da aç Nasıl kurulur

Python (stdlib) · Vanilla JS

Fasıl I

Levhalar

ekranlar, çalışan sürümden

Tek ekran — harcama, canlı limitler ve tüm sağlayıcılar bir arada
Levha ITek ekran — harcama, canlı limitler ve tüm sağlayıcılar bir arada
Gerçek $ harcama — bugün/dün/30 gün + günlük sparkline + model bazında kırılım
Levha IIGerçek $ harcama — bugün/dün/30 gün + günlük sparkline + model bazında kırılım
Canlı Claude limitleri — oturum ve haftalık kullanım yüzdesi (Anthropic ucundan gerçek)
Levha IIICanlı Claude limitleri — oturum ve haftalık kullanım yüzdesi (Anthropic ucundan gerçek)
Çok sağlayıcı — OpenRouter, Codex ve Ollama tek ızgarada
Levha IVÇok sağlayıcı — OpenRouter, Codex ve Ollama tek ızgarada
Kompakt widget modu — masaüstünde fareyle taşınabilen floating pencere
Levha VKompakt widget modu — masaüstünde fareyle taşınabilen floating pencere

Fasıl II

Ne işe yarar

basit anlatım

Bu proje ne?

Tüm AI kullanımımı — token, gerçek $ harcama ve kalan limit — tek panelde toplayan bağımsız bir Linux aracı; artık açık kaynak. Claude için "Pane" benzeri; ayrıca OpenRouter, Codex ve Ollama harcamasını da gösteriyor. Sıfır bağımlılık: sadece Python standart kütüphanesi + Vanilla JS, tamamı loopback (127.0.0.1), veriyi asla dışarı göndermez. Kendi verin olmadan denemek için yerleşik demo modu (USAGE_DEMO=1) sentetik ama gerçekçi veriyle çalışır.

Neyi çözüyor?

Kaç token harcadığımı, aylık gerçek maliyeti ve limite ne kadar kaldığını görmek için dağınık dosyalara ve tahminlere bakıyordum. Bunu tek bakışta, gerçek verilerle görmek istedim — kalibrasyon/tahmin değil, Anthropic'in canlı limit ucundan gelen gerçek yüzde ve resmi fiyat kataloğundan hesaplanan gerçek $.

Fasıl III

Nasıl çalışır

teknik anlatım

Nasıl geliştirdim?

Yerel `~/.claude/projects/**/*.jsonl` transcript'lerinden token kullanımını okuyup (message.id ile dedup, mtime-cache) resmi model fiyat kataloğuyla gerçek $'a çevirdim. Canlı limit için Anthropic OAuth usage ucunu salt-okunur çağırıyorum (token asla yazılmaz/yenilenmez). Çok sağlayıcı desteğini adaptör deseniyle kurdum: her sağlayıcı `collect(days)->dict|None` döndürür, veri yoksa kart hiç açılmaz ("no dead cards"). Arayüz stdlib HTTP sunucusunun servis ettiği tek sayfa; ayrıca Wayland için iki bağımsız yüzey var — waybar rozeti ve fareyle taşınabilir floating widget (Chromium --app penceresi).

Malzemeler

  • Python
  • stdlib
  • Vanilla JS
  • Wayland
  • waybar
  • Anthropic API
  • OpenRouter
  • Linux

Fasıl IV

Neler var

öne çıkanlar

  • Gerçek $ harcama bugün / dün / son 30 gün + günlük sparkline + model bazında kırılım (resmi fiyat kataloğu)
  • Canlı Claude limitleri oturum (5s) ve haftalık kullanım yüzdesi Anthropic ucundan GERÇEK, kalibrasyon/tahmin değil
  • Çok sağlayıcı Claude yanında OpenRouter (gerçek $), Codex (token→$ tahmin) ve Ollama (yerel/ücretsiz) kartları
  • Sıfır bağımlılık yalnızca Python standart kütüphanesi + Vanilla JS; pip install yok
  • Gizlilik loopback-only (127.0.0.1:8770), salt-okunur; hiçbir veri dışarı gitmez, token'a dokunulmaz
  • Linux yüzeyleri izole waybar rozeti + fareyle taşınıp boyutlanabilen floating widget (mevcut config'e dokunmaz)
  • Tek-bakış glance modu kompakt widget: en yüksek limit yüzdesi (renk kodlu), reset sayacı ve günlük harcama tek karede
  • Proaktif uyarı limit %75/%90 eşiğine gelince masaüstü bildirimi (notify-send); tekrar-önleme + reset ile
  • Kullanım tahmini mevcut hızla limite ne zaman ulaşacağını gösteren "≈ X sonra dolar" öngörüsü (güven kapılı)

Fasıl V

Nasıl kullanılır

gündelik kullanım

  1. Günlük kontrol — çalışmaya başlamadan limite ne kadar kaldığına ve bugünkü harcamaya tek bakışta bak
  2. Masaüstünde sabit — waybar rozeti manşette yüzdeyi gösterir; tıkla, detay paneli floating widget olarak açılsın
  3. Maliyet takibi — ay sonu API-eşdeğeri maliyeti ve hangi modelin ne harcadığını gör
  4. Çoklu sağlayıcı — Claude + OpenRouter + Codex + Ollama kullanımını tek ekranda karşılaştır

Fasıl VI

Kur

açık kaynak

Açık Kaynak · MIT

Kendi bilgisayarında çalıştır

usage-tracker artık açık kaynak. MIT lisansıyla ücretsiz kullan, değiştir, dağıt. Sıfır bağımlılık — sadece Python 3 (standart kütüphane) + Vanilla JS, pip install yok. Tamamı loopback (127.0.0.1), verin asla dışarı gitmez. Kurmadan önce USAGE_DEMO=1 ile demo modunda deneyebilirsin.

GitHub'da aç

MIT lisansı · Ücretsiz · kendi sunucunda

Repoya yıldız ver

Neden açık kaynak?

  • Sıfır bağımlılık — Python stdlib + Vanilla JS; pip/npm yok, build yok
  • Gizlilik — loopback-only, salt-okunur; token'a dokunulmaz, veri dışarı gitmez
  • Demo modu — kendi verin olmadan dene (USAGE_DEMO=1), sentetik gerçekçi veri
  • İki Linux yüzeyi — waybar rozeti + fareyle taşınabilen floating widget (mevcut config'e dokunmaz)
  • CodexBar tarzı glance — kompakt widget + eşik bildirimi + kullanım tahmini
  • Katkıya açık — issue aç, PR gönder

Nasıl kurulur?

  1. Gereksinim: Python 3.11+ (Linux). Widget için Chromium ailesi bir tarayıcı (opsiyonel).
  2. git clone https://github.com/ihsandeniz/usage-tracker.git && cd usage-tracker
  3. USAGE_DEMO=1 ./start.sh → tarayıcıda http://127.0.0.1:8770 — demo veriyle önce gör
  4. ./start.sh → kendi ~/.claude verinle gerçek panel (loopback, salt-okunur)
  5. İstersen ./install.sh → waybar rozeti + floating widget; ./service.sh install → açılışta otomatik başlat

Bunun gibi bir şey mi lazım?

Fikrini alıp çalışır hale getirelim — hızlı ve kaliteli.

Bana yaz