CLI

Kodine CLI komutları ve seçenekleri.

Kodine CLI’ı hiçbir argüman vermeden çalıştırırsanız varsayılan olarak TUI açılır.

kodine

Bunun yanında bu sayfada anlatılan komutları da kabul eder; böylece Kodine ile programatik olarak çalışabilirsiniz.

kodine run "Explain how closures work in JavaScript"

tui

Kodine terminal kullanıcı arayüzünü açar.

kodine [project]

Bayraklar

Bayrak	Kısa	Açıklama
`--continue`	`-c`	Son oturumdan devam eder
`--session`	`-s`	Devam edilecek oturum kimliği
`--fork`		Devam ederken oturumu çatallar (`--continue` ya da `--session` ile birlikte)
`--prompt`		Kullanılacak istem
`--model`	`-m`	provider/model biçiminde kullanılacak model
`--agent`		Kullanılacak agent
`--port`		Dinlenecek port
`--hostname`		Dinlenecek host adı

Komutlar

Kodine CLI ayrıca aşağıdaki komutları sunar.

agent

Kodine agent’larını yönetir.

kodine agent [command]

attach

serve veya web ile ayağa kaldırılmış, halen çalışmakta olan bir Kodine arka uç sunucusuna terminal bağlar.

kodine attach [url]

Bu sayede TUI’yi uzaktaki bir Kodine arka ucuna karşı kullanabilirsiniz. Örneğin:

# Web/mobil erişim için arka uç sunucusunu başlat
kodine web --port 4096 --hostname 0.0.0.0

# Başka bir terminalde TUI'yi çalışan arka uca bağla
kodine attach http://10.20.30.40:4096

Bayraklar

Bayrak	Kısa	Tanım
`--dir`		TUI’nin açılacağı çalışma dizini
`--continue`	`-c`	Son oturumdan devam eder
`--session`	`-s`	Devam edilecek oturum bilgisi
`--fork`		Devam ederken oturumu çatallar (`--continue` ya da `--session` ile birlikte)
`--password`	`-p`	Basic auth parolası (varsayılan: `KODINE_SERVER_PASSWORD`)
`--username`	`-u`	Basic auth kullanıcı adı (varsayılan: `KODINE_SERVER_USERNAME` ya da `kodine`)

create

Özel yapılandırmalı yeni bir agent oluşturur.

kodine agent create

Komut, özel sistem istemi ve araç ayarlarıyla bir agent tanımlamanız için sizi adım adım yönlendirir.

list

Var olan tüm agent’ları listeler.

kodine agent list

auth

Sağlayıcı kimlik bilgilerini ve oturum açma işlemlerini yönetir.

kodine auth [command]

Kodine, Models.dev üzerindeki sağlayıcı listesini destekler; dolayısıyla kullanmak istediğiniz herhangi bir sağlayıcının API anahtarını kodine auth login ile tanımlayabilirsiniz. Anahtarlar ~/.local/share/kodine/auth.json dosyasında saklanır.

kodine auth login

Kodine açılırken sağlayıcıları bu kimlik bilgisi dosyasından yükler; ayrıca ortam değişkenlerindeki ve projenizdeki .env dosyasındaki anahtarları da değerlendirir.

list

Kimlik bilgisi dosyasında kayıtlı, kimliği doğrulanmış tüm sağlayıcıları listeler.

kodine auth list

Ya da kısa biçimiyle:

kodine auth ls

logout

İlgili sağlayıcıyı kimlik bilgisi dosyasından silerek oturumu kapatır.

kodine auth logout

github

Depo otomasyonunda kullanılan GitHub aracısını yönetir.

kodine github [command]

install

GitHub aracısını deponuza kurar.

kodine github install

Komut gerekli GitHub Actions workflow’unu hazırlar ve yapılandırma adımlarında size eşlik eder. Daha fazla bilgi.

run

GitHub aracısını çalıştırır; genellikle GitHub Actions içinde kullanılır.

kodine github run

Bayraklar

Bayrak	Açıklama
`--event`	Aracıyı tetikleyen sahte GitHub olayı
`--token`	GitHub personal access token

mcp

Model Context Protocol sunucularını yönetir.

kodine mcp [command]

add

Yapılandırmanıza yeni bir MCP sunucusu ekler.

kodine mcp add

Komut, yerel ya da uzak bir MCP sunucusu eklemeniz için sizi yönlendirir.

list

Tanımlı tüm MCP sunucularını ve bağlantı durumlarını listeler.

kodine mcp list

Dilerseniz kısa biçimini kullanın:

kodine mcp ls

auth

OAuth destekli bir MCP sunucusunda kimlik doğrular.

kodine mcp auth [name]

Sunucu adı vermezseniz, OAuth destekleyen sunucular arasından seçim yapmanız istenir.

OAuth destekli sunucuları ve kimlik doğrulama durumlarını da listeleyebilirsiniz:

kodine mcp auth list

Ya da kısa biçimiyle:

kodine mcp auth ls

logout

Bir MCP sunucusuna ait OAuth kimlik bilgilerini kaldırır.

kodine mcp logout [name]

debug

Bir MCP sunucusundaki OAuth bağlantı sorunlarını inceler.

kodine mcp debug <name>

models

Yapılandırılmış sağlayıcıların kullanılabilir tüm modellerini listeler.

kodine models [provider]

Komut, tanımlı sağlayıcılarınızdaki modelleri provider/model biçiminde gösterir.

Yapılandırma dosyanızda kullanacağınız tam model adını bulmak için pratiktir.

İsteğe bağlı bir sağlayıcı kimliği vererek sonuçları o sağlayıcıyla sınırlayabilirsiniz:

kodine models kodine

Bayraklar

Bayrak	Tanım
`--refresh`	Models.dev üzerindeki model önbelleğini tazeler
`--verbose`	Daha ayrıntılı çıktı verir (maliyet gibi üst verileri de gösterir)

Önbelleğe alınmış model listesini güncellemek için --refresh bayrağını kullanın; bir sağlayıcıya yeni modeller eklendiğinde bunları Kodine’da görmek için işe yarar.

kodine models --refresh

run

Kodine’ı etkileşimsiz modda, doğrudan bir istem vererek çalıştırır.

kodine run [message..]

Betik yazımı, otomasyon ya da TUI’nin tamamını açmadan hızlı bir yanıt alma durumlarında kullanışlıdır. Örneğin:

kodine run Explain the use of context in Go

Ayrıca her çalıştırmada MCP sunucularının soğuk açılış süresinden kurtulmak için halen çalışan bir kodine serve örneğine bağlanabilirsiniz:

# Bir terminalde başsız sunucuyu başlat
kodine serve

# Başka bir terminalde ona bağlanan komutlar çalıştır
kodine run --attach http://localhost:4096 "Explain async/await in JavaScript"

Bayraklar

Bayrak	Kısa	Açıklama
`--command`		Çalıştırılacak komut; argümanlar için mesajı kullanın
`--continue`	`-c`	Son oturumdan devam eder
`--session`	`-s`	Devam edilecek oturum kimliği
`--fork`		Devam ederken oturumu çatallar (`--continue` ya da `--session` ile birlikte)
`--share`		Oturumu paylaşır
`--model`	`-m`	provider/model biçiminde kullanılacak model
`--agent`		Kullanılacak agent
`--file`	`-f`	Mesaja eklenecek dosya(lar)
`--format`		Biçim: default (biçimlendirilmiş) ya da json (ham JSON olayları)
`--title`		Oturum başlığı (verilmezse kısaltılmış istem kullanılır)
`--attach`		Çalışan bir Kodine sunucusuna bağlanır (ör. http://localhost:4096)
`--password`	`-p`	Basic auth parolası (varsayılan: `KODINE_SERVER_PASSWORD`)
`--username`	`-u`	Basic auth kullanıcı adı (varsayılan: `KODINE_SERVER_USERNAME` ya da `kodine`)
`--dir`		Çalışılacak dizin; bağlanırken uzak sunucudaki yol
`--variant`		Model varyantı (sağlayıcıya özgü akıl yürütme düzeyi)
`--thinking`		Düşünme bloklarını gösterir
`--port`		Yerel sunucunun portu (varsayılan olarak rastgele bir port seçilir)

serve

API erişimi için başsız bir Kodine sunucusu açar. Tam HTTP arayüzü için sunucu belgelerine bakın.

kodine serve

Bu komut, TUI olmadan Kodine işlevlerine API üzerinden erişmenizi sağlayan bir HTTP sunucusu başlatır. HTTP basic auth’u açmak için KODINE_SERVER_PASSWORD değişkenini ayarlayın (kullanıcı adı varsayılan olarak kodine alınır).

Bayraklar

Bayrak	Tanım
`--port`	Dinlenecek port
`--hostname`	Dinlenecek host adı
`--mdns`	mDNS keşfini açar
`--cors`	CORS’a izin verilecek ek tarayıcı kaynakları

session

Kodine oturumlarını yönetir.

kodine session [command]

list

Tüm Kodine oturumlarını listeler.

kodine session list

Bayraklar

Bayrak	Kısa	Tanım
`--max-count`	`-n`	En güncel N oturumla sınırlar
`--format`		Çıktı biçimi: table veya json (table)

stats

Kodine oturumlarınıza ait token kullanımını ve maliyet istatistiklerini gösterir.

kodine stats

Bayraklar

Bayrak	Açıklama
`--days`	Son N günün istatistiklerini gösterir (tüm zamanlar)
`--tools`	Gösterilecek araç sayısı (tümü)
`--models`	Model kullanım dökümünü gösterir (varsayılan olarak gizli). İlk N kayıt için bir sayı verin
`--project`	Projeye göre filtreler (tüm projeler; boş değer: geçerli proje)

export

Oturum verilerini JSON olarak dışa aktarır.

kodine export [sessionID]

Oturum kimliği vermezseniz mevcut oturumlar arasından seçim yapmanız istenir.

import

Bir JSON dosyasından ya da Kodine paylaşım URL’sinden oturum verilerini içe aktarır.

kodine import <file>

Yerel bir dosyadan veya bir Kodine paylaşımından (URL) içe aktarım yapabilirsiniz:

kodine import session.json
kodine import https://kodine.net/s/abc123

web

Web arayüzü sunan başsız bir Kodine sunucusu açar.

kodine web

Bu komut bir HTTP sunucusu başlatır ve Kodine’a web arayüzünden erişmeniz için tarayıcıyı açar. HTTP basic auth’u etkinleştirmek için KODINE_SERVER_PASSWORD değişkenini ayarlayın (kullanıcı adı varsayılan olarak kodine alınır).

Bayraklar

Bayrak	Tanım
`--port`	Dinlenecek port
`--hostname`	Dinlenecek host adı
`--mdns`	mDNS keşfini açar
`--cors`	CORS’a izin verilecek ek tarayıcı kaynakları

acp

Bir ACP (Agent Client Protocol) sunucusu başlatır.

kodine acp

Bu komut, stdin/stdout üzerinden nd-JSON ile iletişim kuran bir ACP sunucusu ayağa kaldırır.

Bayraklar

Bayrak	Açıklama
`--cwd`	Çalışma dizini
`--port`	Dinlenecek port
`--hostname`	Dinlenecek host adı

uninstall

Kodine’ı ve ilişkili tüm dosyaları sisteminizden kaldırır.

kodine uninstall

Bayraklar

Bayrak	Kısa	Tanım
`--keep-config`	`-c`	Yapılandırma dosyalarını korur
`--keep-data`	`-d`	Oturum verilerini ve anlık görüntüleri korur
`--dry-run`		Nelerin silineceğini silmeden gösterir
`--force`	`-f`	Onay sorularını atlar

upgrade

Kodine’ı en güncel sürüme ya da belirttiğiniz bir sürüme yükseltir.

kodine upgrade [target]

En güncel sürüme geçmek için:

kodine upgrade

Belirli bir sürüme geçmek için:

kodine upgrade v0.1.48

Bayraklar

Bayrak	Kısa	Açıklama
`--method`	`-m`	Kullanılan kurulum yöntemi: curl, npm, pnpm, bun, brew

Global bayraklar

Kodine CLI şu global bayrakları destekler:

Bayrak	Kısa	Tanım
`--help`	`-h`	Yardımı gösterir
`--version`	`-v`	Sürüm numarasını yazdırır
`--print-logs`		Günlükleri stderr’e yazar
`--log-level`		Günlük düzeyi (DEBUG, INFO, WARN, ERROR)

Ortam değişkenleri

Kodine, ortam değişkenleri aracılığıyla da yapılandırılabilir.

Değişken	Tip	Açıklama
`KODINE_AUTO_SHARE`	boolean	Oturumları otomatik olarak paylaşır
`KODINE_GIT_BASH_PATH`	string	Windows’ta Git Bash çalıştırılabilir dosyasının yolu
`KODINE_CONFIG`	string	Yapılandırma dosyasının yolu
`KODINE_TUI_CONFIG`	string	TUI yapılandırma dosyasının yolu
`KODINE_CONFIG_DIR`	string	Yapılandırma dizininin yolu
`KODINE_CONFIG_CONTENT`	string	Satır içi JSON yapılandırma içeriği
`KODINE_DISABLE_AUTOUPDATE`	boolean	Otomatik güncelleme denetimlerini kapatır
`KODINE_DISABLE_PRUNE`	boolean	Eski verilerin temizlenmesini kapatır
`KODINE_DISABLE_TERMINAL_TITLE`	boolean	Otomatik terminal başlığı güncellemelerini kapatır
`KODINE_PERMISSION`	string	Satır içi JSON izin yapılandırması
`KODINE_DISABLE_DEFAULT_PLUGINS`	boolean	Varsayılan eklentileri kapatır
`KODINE_DISABLE_LSP_DOWNLOAD`	boolean	Otomatik LSP sunucu indirmelerini kapatır
`KODINE_ENABLE_EXPERIMENTAL_MODELS`	boolean	Deneysel modelleri açar
`KODINE_DISABLE_AUTOCOMPACT`	boolean	Otomatik bağlam sıkıştırmayı kapatır
`KODINE_DISABLE_CLAUDE_CODE`	boolean	`.claude` altından okumayı kapatır (istemler + beceriler)
`KODINE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	`~/.claude/CLAUDE.md` dosyasının okunmasını kapatır
`KODINE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	`.claude/skills` yüklemesini kapatır
`KODINE_DISABLE_MODELS_FETCH`	boolean	Uzak kaynaklardan model listesi çekmeyi kapatır
`KODINE_FAKE_VCS`	string	Test amaçlı sahte VCS sağlayıcısı
`KODINE_CLIENT`	string	Client kimliği (varsayılan: `cli`)
`KODINE_ENABLE_EXA`	boolean	Exa web arama araçlarını açar
`KODINE_SERVER_PASSWORD`	string	`serve`/`web` için basic auth’u etkinleştirir
`KODINE_SERVER_USERNAME`	string	Basic auth kullanıcı adını değiştirir (varsayılan `kodine`)
`KODINE_MODELS_URL`	string	Model yapılandırmasını almak için özel URL

Deneysel

Aşağıdaki ortam değişkenleri, ileride değişebilecek ya da kaldırılabilecek deneysel özellikleri açar.

Değişken	Tip	Tanım
`KODINE_EXPERIMENTAL`	boolean	Şemsiye bayrağına bağlı deneysel özellikleri açar
`KODINE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Simge keşfini açar
`KODINE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	TUI’de seçim yapınca kopyalamayı kapatır
`KODINE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Bash komutları için milisaniye cinsinden varsayılan zaman aşımı
`KODINE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	LLM yanıtlarında azami çıktı token sayısı
`KODINE_EXPERIMENTAL_FILEWATCHER`	boolean	Tüm dizinlerde dosya izleyiciyi açar
`KODINE_EXPERIMENTAL_OXFMT`	boolean	Oxfmt biçimlendiriciyi açar
`KODINE_EXPERIMENTAL_LSP_TOOL`	boolean	Deneysel LSP aracını açar
`KODINE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Dosya izleyiciyi kapatır
`KODINE_EXPERIMENTAL_EXA`	boolean	Deneysel Exa özelliklerini açar
`KODINE_EXPERIMENTAL_LSP_TY`	boolean	Python dosyalarında TY LSP’yi açar
`KODINE_EXPERIMENTAL_PLAN_MODE`	boolean	Plan modunu açar
`KODINE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	Arka planda çalışan alt ajan görevlerini açar
`KODINE_EXPERIMENTAL_EVENT_SYSTEM`	boolean	Deneysel olay sistemini açar
`KODINE_EXPERIMENTAL_NATIVE_LLM`	boolean	Yerel LLM istek yolunu açar
`KODINE_EXPERIMENTAL_PARALLEL`	boolean	Paralel web araması yürütmesini açar
`KODINE_EXPERIMENTAL_SCOUT`	boolean	Scout alt ajanını açar
`KODINE_EXPERIMENTAL_WORKSPACES`	boolean	Çalışma alanı desteğini açar