kanka

Türkçe konuşan terminal kodlama asistanı.
"Kanka, şunu yapsana."

🌐 kankam.ai  ·  📦 npm  ·  💬 Discussions

---

Nedir?

kanka, terminalde Türkçe konuşarak kullanabileceğin bir AI kodlama asistanıdır. Claude, GPT, Gemini, GLM gibi LLM'leri arkanda kullanır; sen kanka yazarsın, o işi yapar.

$ kanka
> Bana NextJS + Tailwind ile minimal bir landing page yap

🌐 Canlı tanıtım: kankam.ai — interaktif persona switcher, KVKK skill detayları, token tasarrufu benchmark'ları.

✨ 8 Ana Özellik

Kanka sıradan bir Türkçe wrapper değil — Pi-coding-agent SDK'sının tam gücünü Türk geliştirici kültürüne uyarlayan mature bir agent. İşte can alıcı 8 özellik:

#	Özellik	Açıklama
🎭	Persona sistemi	4 hazır kişilik (kanka, hoca, abi, patron) — aynı soru, farklı ton
📓	Geliştirme günlüğü	Proje bazlı kararlar, fix'ler, deployment notları
🔔	Windows Terminal entegrasyonu	Canlı tab title + masaüstü bildirim
🔄	Otomatik güncelleme	Pasif kontrol + /güncelle + kanka update CLI
🤝	9 uzman subagent	İzole context'te çalışan Türkçe ekip
🔗	Chain + paralel async	Tek komutla pipeline + N agent paralel
💰	Token tasarrufu	Cache + izolasyon + paralel = ~70% maliyet düşüşü
🔌	10+ LLM provider	Claude, GPT, Gemini, GLM, Grok, Trendyol, Ollama...

---

1. 🎭 Persona sistemi

Aynı soru, farklı ton. Kanka 7 hazır kişilikle gelir — sistem prompt'a dinamik olarak enjekte edilir, her cevapta etkili olur.

Kişilik	Stil	Ne zaman?
🤝 kanka	Samimi, rahat, profesyonel	Varsayılan. Günlük iş.
🧑‍🏫 hoca	Öğretici, "neden" açıklayan	Öğrenirken, junior dev
🧔 abi	Senior dev, direkt, kısa	Hızlı iş, gereksiz açıklama yok
💼 patron	Pragmatik, MVP odaklı	Deadline, demo, hızlı iterasyon

/kisilik              # mevcut kişiliği ve listeyi gör
/kisilik hoca         # hoca moduna geç
/kisilikler           # detaylı katalog

Aynı soru "Fibonacci yazsana":

• 🤝 kanka: "Tamamdır kanka, hemen yazalım..."
• 🧑‍🏫 hoca: "Önce 'recursive' nedir bakalım. Fibonacci serisi şöyle bir özelliği var..."
• 🧔 abi: function fib(n) { return n < 2 ? n : fib(n-1) + fib(n-2); }. Bu kadar.
• 💼 patron: "Production'da memoize'lı versiyon kullan, MVP için bu yeter."

Kendi personanı ekle: ~/.kanka/personas/<isim>.md

---
name: paranoyak
description: Güvenlik öncelikli, her input'a şüpheyle bakar
emoji: 🔒
---

## Kişiliğin
- Her kullanıcı girdisini "potansiyel saldırı" varsayarsın
- SQL injection, XSS, CSRF risklerini öncelikle düşünürsün
- ...

---

2. 📓 Geliştirme günlüğü

Proje bazlı append-only günlük — kararlar, bug fix'ler, deployment notları, ne öğrendin. Tag desteği ile, anında arama. Dosya: ~/.kanka/gunlukler/<proje>.jsonl

/gunluk yaz auth refresh token bug düzeltildi #fix #auth
/gunluk yaz NextJS 15'e migrate başladı #frontend #nextjs
/gunluk bugun                       # bugünün notları
/gunluk son 10                      # son 10 kayıt
/gunluk ara auth                    # "auth" geçen tüm notlar
/gunluk istatistik                  # toplam, ilk/son, en çok etiket

Format (her satır bir JSON):

{"ts":"2026-05-18T14:23:12.000Z","proje":"my-app","metin":"auth refresh token bug düzeltildi","etiketler":["fix","auth"]}

Türkçe karakter alias: /günlük de çalışır.

Neden lokal JSONL?

• ✅ Telemetry yok — verin sende kalır
• ✅ cat | grep ile shell'de de okunur
• ✅ Append-only, race condition yok
• ✅ Git'e commit edebilirsin (.kanka/gunlukler/proje.jsonl)

---

3. 🔔 Windows Terminal entegrasyonu

Çoğu coding agent macOS/Linux odaklı — kanka Windows kullanıcılarını birinci sınıf vatandaş olarak görür.

Tab title canlı güncellenir (OSC 0):

Durum	Tab title
Agent boştayken	kanka · hazır
LLM düşünürken	kanka · düşünüyor…
Bash çalışırken	kanka · komut çalıştırıyor
Read sırasında	kanka · dosya okuyor
Write sırasında	kanka · dosya yazıyor
Subagent çalışırken	kanka · subagent çağırıyor

Masaüstü bildirim (OSC 9) — 30s+ süren tool'lar bitince:

🔔 kanka
cevabım hazır (32s)

Sen başka pencereye bakıyorsan haberdar olursun. Multi-tasking için ideal.

Test komutları:

/tab-title kanka · test            # manuel tab title (debug)
/bildir test bildirimi              # manuel toast (debug)

Devre dışı: KANKA_NO_TERMINAL_INTEGRATION=1

Desteklenen terminaller: Windows Terminal, WezTerm, iTerm2 (OSC 0+9 desteği olan herhangi terminal).

---

4. 🔄 Otomatik güncelleme

Kanka günde 1 kere npm registry'ye bakar, yeni sürüm varsa header'da bildirim gösterir. Update sistemi 3 katmanlı:

# 1) Pasif uyarı (otomatik)
kanka
# Header'da gözükür: 📦 Yeni sürüm var: 0.4.0 → 0.5.0 · Güncellemek için: /güncelle

# 2) Oturum içinden (interaktif onay)
/güncelle                  # kontrol + onay + npm install -g
/versiyon-kontrol          # sadece kontrol et

# 3) Komut satırından (standalone)
kanka update               # latest'e geç
kanka update --check       # sadece kontrol

Cache yönetimi (~/.kanka/son-versiyon-kontrol):

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

24 saatte bir taze kontrol. Sürüm karşılaştırma semver uyumlu (major.minor.patch).

Devre dışı:

KANKA_NO_UPDATE_CHECK=1      # Pasif kontrol kapanır (npm view çağrılmaz)
KANKA_NO_UPDATE_PROMPT=1     # Header'da bildirim görünmez

Yetki hatası:

• Linux/macOS: sudo npm install -g @thorrangonak/kanka@latest
• Windows: PowerShell'i yönetici aç veya nvm-windows kullan (root yetki sorunu yok)

---

5. 🤝 9 uzman subagent ekibi

Kanka 9 uzman agent'la birlikte gelir. Her biri izole context'te çalışır (ana sohbetin bağlamından izole), kendi uzmanlık alanında özelleşmiştir, Türkçe rapor verir.

Agent	Görevi	Tipik kullanım
🔍 kasif	Hızlı kod keşif, sıkıştırılmış context	Yeni codebase'e bakarken
📋 planlayici	Uygulama planı çıkarma (hiç değiştirmez)	"Önce ne yapayım?"
⚙️ isci	Genel amaçlı uygulamacı, tam yetki	Hemen kodu yaz
🔎 gozden-geciren	Code review, kalite/güvenlik analizi	PR review öncesi
🏛️ mimar	Sistem mimarisi, trade-off analizi	"Microservice mi monolith mi?"
🐛 hata-avcisi	Bug analizi, root cause, stack trace	"Bu neden patlıyor?"
🧪 test-yazari	Test senaryoları + test kodu	Coverage artırma
♻️ refactorcu	Davranış korunarak refactor	Code smell temizleme
📖 docs-yazari	README, API docs, JSDoc, Mermaid	Dokümantasyon eksikse

Çağırma: delege tool'u veya chain workflow'lar (aşağıda).

Kendi agent'ını ekle: ~/.kanka/agents/<isim>.md veya .pi/agents/<isim>.md

---

6. 🔗 Chain + paralel async

İki güçlü mod:

a) Sequential chain (boru hattı)

Tek komutla birden fazla agent sırayla çalışır, her biri öncekinin çıktısını alır:

/yap kullanıcı kayıt formu ekle, validation + test
# → kasif → planlayici → isci
#    (keşif)   (plan)    (uygula)

Hazır chain komutları:

Komut	Pipeline
/yap <görev>	kasif → planlayici → isci
/plan-yap <görev>	kasif → planlayici (sadece plan, kod yazmaz)
/yap-ve-incele <görev>	isci → gozden-geciren → isci (review feedback'i uygular)
/hata-ayikla <bug>	kasif → hata-avcisi (root cause)
/refactor-incele <hedef>	kasif → refactorcu → gozden-geciren

Kendi workflow'unu yazmak: ~/.kanka/prompts/<isim>.md veya .pi/prompts/<isim>.md

b) Paralel async

3 agent aynı anda farklı görevde çalışsın:

// SDK üzerinden — programatik
await delege({
  tasks: [
    { agent: "kasif",       task: "frontend keşif" },
    { agent: "test-yazari", task: "backend test'leri yaz" },
    { agent: "gozden-geciren", task: "PR review" },
  ],
  concurrency: 3,
});

Wall-clock 3x hız — toplam token aynı ama bekleme süresi 1/3.

Async + worktree: Git worktree ile her agent ayrı dosya sistemi izolasyonu alır, conflict yok.

await delege({
  tasks: [...],
  worktree: true,  // her tasks[i] ayrı git worktree'de
});

---

7. 💰 Token tasarrufu (60-80%)

3 katmanlı optimizasyon kanka'yı çıplak LLM kullanımına göre çok ucuza getirir:

a) Prompt Cache (~70% tasarruf)

Anthropic prompt caching + Z.AI cache desteği. Sistem prompt'u, skill'ler, AGENTS.md gibi statik içerikler 5 dakika cache'lenir.

İlk turn:  $0.018 (cache miss, full write)
Sonraki:   $0.002 (cache hit, %10 fiyat)

Bir oturumda 50 turn varsa 48'i cache hit — büyük tasarruf.

b) İzole Context (~50% tasarruf)

Subagent kendi context'inde çalışır. Ana sohbet sadece özet alır.

Ana agent:  20 mesaj × ~2k token = 40k token context
  └→ kasif delege olur
       └→ kasif kendi context'inde çalışır (200k+ token kullanabilir)
       └→ ANA AGENT'A SADECE 500 TOKENLİK ÖZET DÖNER

Subagent ne kadar derin keşif yaparsa yapsın, ana sohbet şişmez.

c) Paralel Async (~3x hız)

3 agent paralel çalışırsa wall-clock süresi 1/3'e iner. Token aynı ama:

• Kullanıcı daha az bekler
• API rate limit dağıtılır
• Sıralı bağımlılık yoksa anlamsız sıralı bekleme yok

Örnek karşılaştırma: 5 dosyalık refactor

Yaklaşım	Token	Maliyet	Süre
❌ Çıplak Claude API	~180,000	$1.80	12 dakika
✅ kanka (opt. aktif)	~54,000	$0.45	4 dakika
💰 Kazanç	-70%	-75%	-66%

Bonus: OAuth (Claude Pro/Max)

Claude Pro/Max aboneliğin varsa marginal cost = $0:

/giriş               # OAuth flow
# Anthropic Pro/Max ($20/ay) ile sınırsız Opus + Sonnet

Token sayma derdi yok — aylık abonelik kapsamında.

---

8. 🔌 10+ LLM provider

Tek paket, istediğin LLM. API key koy, kullan. Pi-coding-agent'ın provider sisteminden faydalanır — kanka sadece Türkçe ambalaj.

Desteklenen provider'lar

Provider	Sağlayıcı	Modeller	Auth
Claude	Anthropic	Opus 4.7, Sonnet 4.6, Haiku	API key veya OAuth
GPT	OpenAI	GPT-5, o4, GPT-4.1	API key
Gemini	Google	2.5 Pro, 2.5 Flash	API key
GLM	Z.AI	GLM-5.1, GLM-4.7	API key (Coding Plan ile $0)
Grok	xAI	Grok 4, Grok 4 Fast	API key
DeepSeek	DeepSeek	V3, R1 (reasoning)	API key
Llama	Meta (via Groq/Together/lokal)	3.3, 4	API key veya lokal
🇹🇷 Trendyol-LLM	Trendyol	Türkçe-fine-tuned	API key (yerli model!)
MiniMax	MiniMax	abab6.5	API key
Ollama	Lokal	Herhangi GGUF model	Local, offline

Kurulum — 3 yol

# Yöntem 1: Komut içi login
kanka
> /giriş         # Provider listesi açılır, API key sorar

# Yöntem 2: Canlı model değiştir
> /model         # Listeden seç (veya Ctrl+P ile cycle)

# Yöntem 3: .env dosyası (otomatik bulur)
# ~/.pi/.env veya proje kökünde
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-proj-...
GEMINI_API_KEY=AIza...
XAI_API_KEY=xai-...
ZAI_API_KEY=...

Hibrit kullanım — task'a göre model

Akıllı yaklaşım: her görev için en uygun model.

// Programatik subagent override
await delege({
  agent: "kasif",
  task: "frontend keşif",
  model: "google/gemini-2.5-flash",  // Hızlı + ucuz keşif için
});

await delege({
  agent: "isci",
  task: "kompleks refactor",
  model: "anthropic/claude-opus-4-7",  // Derin reasoning için
});

Yerli model — Trendyol-LLM

🇹🇷 Trendyol-LLM Türkçe için fine-tune edilmiş — özellikle Türkçe context'lerde Claude/GPT'den daha iyi performans veriyor. Kanka roadmap'inde native integration geliyor (Faz 3).

---

Kurulum

npm install -g @thorrangonak/kanka

Hızlı başlangıç

API anahtarınla giriş yap:

export ANTHROPIC_API_KEY=sk-ant-...
kanka

Veya mevcut Claude Pro/Max aboneliğinle:

kanka
/giriş

Sonra konuş kanka'yla:

> sana güveniyorum kanka, şu projeyi ayağa kaldır
> hata var şurada, bul ve düzelt
> testlerimi yaz

Türkçe komut referansı

35+ Türkçe slash komutu var. Hepsinin ASCII versiyonu da çalışır (Türkçe karakter zor gelirse).

📁 Temel

Komut	Açıklama
/yardım	Bu yardım listesi
/çık	Oturumdan çık
/bilgi	Kanka durum özeti (versiyon + model + thinking + ekip)
/ekip	Subagent ekibini listele
/araçlar	Aktif tool listesi
/düşünce <seviye>	Thinking level (kapat/min/düşük/orta/yüksek/max)
/selam	kanka'dan bir selam

🎭 Kişilik

Komut	Açıklama
/kisilik	Mevcut + liste
/kisilik <isim>	Kişilik değiştir
/kisilikler	Detaylı katalog

📓 Günlük

Komut	Açıklama
/gunluk yaz <metin>	Yeni giriş
/gunluk bugun	Bugünün girişleri
/gunluk son [N]	Son N giriş
/gunluk ara <kelime>	Substring arama
/gunluk istatistik	Özet

🔗 Workflow (chain)

Komut	Pipeline
/yap <görev>	kasif → planlayici → isci
/plan-yap <görev>	kasif → planlayici
/yap-ve-incele <görev>	isci → gozden-geciren → isci
/hata-ayikla <bug>	kasif → hata-avcisi
/refactor-incele <hedef>	kasif → refactorcu → gozden-geciren

🔄 Güncelleme

Komut	Açıklama
/güncelle	Latest'e güncelle (interaktif)
/versiyon-kontrol	Sadece kontrol

🔔 Terminal

Komut	Açıklama
/tab-title <metin>	Manuel tab title (test/debug)
/bildir <metin>	Test toast bildirimi

🗂️ Context yönetimi

Türkçe	Pi orijinal
/sıkıştır / /özet	/compact
/yenile	/reload

💾 Oturum yönetimi

Türkçe	Pi orijinal
/çatalla	/fork
/klonla	/clone
/devam	/resume
/ağaç	/tree
/isim	/name
/içeal	/import
/aktar	/export
/paylaş	/share
/kopyala	/copy

🔐 Auth & ayarlar

Türkçe	Pi orijinal
/giriş	/login
/çıkış	/logout
/ayarlar	/settings
/kısayollar	/hotkeys

Pi'nin orijinal İngilizce komutları da her zaman çalışır.

CLI bayrakları

kanka --yardım            # Türkçe yardım
kanka --versiyon          # Versiyon
kanka "görev"             # Doğrudan görev ver
echo "iş" | kanka         # Stdin'den mesaj
kanka update              # Latest'e güncelle
kanka update --check      # Sadece kontrol

Felsefe

Kanka, pi-coding-agent çekirdeğini kullanır. Pi'nin "minimal, hackable, kendi workflow'una uyarla" felsefesini paylaşır — sadece dili ve markası Türk.

• Karmaşık olmasın, anlaşılır olsun.
• "Sub-agent", "plan mode" gibi kapalı kutu özellikler yok. İstersen extension olarak yaz.
• Sistem prompt'u, komutlar, temalar, persona'lar — hepsi düzenlenebilir.

Geliştirme

git clone https://github.com/thorrangonak/kanka.git
cd kanka
npm install
npm run build
node dist/cli.js

Daha fazlası: TEST.md — interaktif test kılavuzu.

Yol haritası

• v0.4.0 ✅ Persona + Günlük + Terminal entegrasyonu + Update sistemi
• v0.5.0 ✅ 3 yeni persona (akademisyen, stajyer, paranoyak), KVKK skill, easter eggs, /istatistik, version sync
• v0.5.1 ✅ Resmi tanıtım sitesi yayında → kankam.ai
• v0.6.0 (planlanmakta): /inceleme-modu, /onerim (proje scan), tema sistemi, test suite
• v0.7.0 (uzun vadeli): MCP entegrasyonu, daha fazla Türkçe skill (e-fatura, iyzico, e-Devlet OAuth)

Detaylı yol haritası: ROADMAP.md

Katkı

Issue/PR memnuniyetle. Türkçe katkılar özellikle memnuniyetle — README hatası, persona önerisi, skill ekleme.

3 "good first issue" hazır:

• #1 memur personası ekle
• #2 iban-validate skill yaz
• #3 /şaka listesine yeni şakalar ekle

Detay: CONTRIBUTING.md

Linkler

• 🌐 Resmi site: kankam.ai
• 📦 npm: @thorrangonak/kanka
• 🐙 GitHub: thorrangonak/kanka
• 💬 Discussions: topluluk sohbeti
• 📝 Issues: bug & feature
• 🔗 Sürümler: GitHub Releases

Lisans

MIT © thorrangonak

Built on pi-coding-agent (MIT) © Mario Zechner / Earendil Works.