Özellik detayı · 4 / 8

Otomatik Güncelleme

Hep güncel kal, dert etme. /güncelle yeter.

Kanka günde 1 kez pasif olarak npm registry'ye bakar, yeni sürüm varsa header'da bildirim gösterir. 3 katmanlı update sistemi — pasif uyarı, komut içi onay, CLI subcommand.

TL;DR

▸Günde 1 kez pasif npm view check (24h cache)
▸Header'da bildirim: '📦 Yeni sürüm var: 0.4.1 → 0.5.0'
▸/güncelle — interaktif onay + npm install
▸kanka update — standalone CLI subcommand (oturum içi olmayan)
▸KANKA_NO_UPDATE_CHECK=1 ile pasif kontrolu kapat

3 yol

kankaPasif uyarı — header'da otomatik gözükür (yeni sürüm varsa)

/güncelleOturum içinden interaktif güncelleme (onay sorar)

/versiyon-kontrolSadece kontrol, kurulum yok

kanka updateStandalone CLI — latest sürüme atla

kanka update --checkSadece kontrol et

Akış

tipik güncelleme

$kanka

╦╔═╔═╗╔╗╔╦╔═╔═╗

╠╩╗╠═╣║║║╠╩╗╠═╣

╩ ╩╩ ╩╝╚╝╩ ╩╩ ╩

kanka v0.4.1 · Türkçe konuşan terminal kodlama asistanı

/yardım komutlar · /ekip subagent'lar · /bilgi durum

📦 Yeni sürüm var: 0.4.1 → 0.5.0 · Güncellemek için: /güncelle

>/güncelle

📡 npm registry kontrol ediliyor...

📦 Yeni sürüm: 0.4.1 → 0.5.0

Güncellemek istiyor musun? [E/h]: e

📥 npm install -g @thorrangonak/kanka@0.5.0

...

✓Tamamdır kanka! kanka@0.5.0 yüklendi.

Cache yapısı

Pasif kontrol 24 saatte bir gerçek npm registry call yapar. Diğer açılışlarda cache okur:

~/.kanka/son-versiyon-kontrol· json

{
  "ts": "2026-05-18T14:23:00Z",
  "mevcut": "0.4.1",
  "latest": "0.5.0",
  "guncelMi": false
}

Cache 24 saat sonra otomatik invalidate. /güncelle veya /versiyon-kontrol manuel refresh tetikler.

Devre dışı bırakma

# Pasif kontrol kapanır (npm view çağrılmaz)
export KANKA_NO_UPDATE_CHECK=1

# Header'da bildirim gözükmez (ama kontrol arka planda çalışır)
export KANKA_NO_UPDATE_PROMPT=1

ℹ

Air-gapped / corporate firewall arkasındaysan KANKA_NO_UPDATE_CHECK=1 yap — gereksiz npm registry HTTP'sini önler.

Yetki hatası

Linux/macOS'ta global npm install için sudo gerekir genelde. Çözümler:

`sudo npm install -g @thorrangonak/kanka@latest` (basit ama sudo)
nvm (Node Version Manager) — kullanıcı bazlı kurulum, sudo gerekmez
Windows'ta: PowerShell'i yönetici aç veya nvm-windows kullan
npm prefix'i ~/.npm-global'a değiştir — sudo'suz global install

Semver davranışı

Kanka semantic versioning kullanır (semver). Aşağıdaki sürüm tipleri otomatik öneriliyor:

Tip	Örnek	Otomatik bildirim?	Önerilen aksiyon
Patch	0.5.0 → 0.5.1	Evet	Bug fix — güvenle güncelle
Minor	0.5.0 → 0.6.0	Evet	Yeni feature — değişiklik geriye uyumlu
Major	0.5.0 → 1.0.0	Evet (uyarıyla)	Breaking change olabilir — release notes oku

Sıkça Sorulanlar

kanka update beni neden eski sürüme indiriyor?

İndirmez — sadece npm'deki latest tag'e geçer. Eğer npm publish edilen son sürümün lokalindekinden eski varsa, npm'deki kazanır.

Belirli sürüme geçmek istersem?

kanka update CLI'da şu an yok. Manuel: npm install -g @thorrangonak/kanka@<version>

Pasif kontrol kaç kez network çağrısı yapıyor?

24 saatte 1 kez. Kanka 10 kere açılsa bile sadece 1 kontrol — cache 24h.