Sunucu

kodine serve komutu, kodine istemcilerinin kullanabileceği bir OpenAPI uç noktası açan headless bir HTTP sunucusu başlatır.

---

Kullanım

kodine serve [--port <number>] [--hostname <string>] [--cors <origin>]

Seçenekler

Bayrak	Açıklama	Varsayılan
--port	Dinlenecek bağlantı noktası	4096
--hostname	Dinlenecek ana bilgisayar adı	127.0.0.1
--mdns	mDNS keşfini açar	false
--mdns-domain	mDNS hizmeti için özel alan adı	kodine.local
--cors	İzin verilecek ek tarayıcı kaynakları (origin)	[]

--cors birden fazla kez verilebilir:

kodine serve --cors http://localhost:5173 --cors https://app.example.com

---

Kimlik Doğrulama

Sunucuyu HTTP basic auth ile korumak için KODINE_SERVER_PASSWORD değişkenini ayarlayın. Kullanıcı adı varsayılan olarak kodine olur; farklı bir değer isterseniz KODINE_SERVER_USERNAME tanımlayabilirsiniz. Bu ayar hem kodine serve hem de kodine web için geçerlidir.

KODINE_SERVER_PASSWORD=your-password kodine serve

---

Nasıl çalışır

kodine komutunu çalıştırdığınızda hem TUI hem de sunucu başlar; TUI, sunucuyla konuşan istemci tarafıdır. Sunucu bir OpenAPI 3.1 spesifikasyon uç noktası açar ve bu uç nokta SDK üretiminde de kullanılır.

Tip

kodine ile programatik etkileşim gerektiğinde kodine sunucusunu kullanın.

Bu mimari sayesinde kodine birden fazla istemciyi destekleyebilir ve programatik kullanım senaryolarına olanak tanır.

kodine serve ile bağımsız bir sunucu başlatabilirsiniz; kodine TUI zaten açıksa kodine serve yeni bir sunucu açar.

---

Mevcut sunucuya bağlanın

TUI başlatıldığında rastgele bir port ve hostname alır. Bunun yerine --hostname ve --port bayraklarını verebilirsiniz.

/tui uç noktası, TUI’yi sunucu üzerinden yönetmeye yarar; örneğin bir istemi önceden doldurabilir veya çalıştırabilirsiniz. kodine IDE eklentileri bu kurulumdan yararlanır.

---

Spesifikasyon

Sunucu, aşağıdaki adresten erişilebilen bir OpenAPI 3.1 spesifikasyonu yayımlar:

http://<hostname>:<port>/doc

Örneğin http://localhost:4096/doc. İstemci üretmek, istek/yanıt tiplerini incelemek veya Swagger gezgininde açmak için bu spesifikasyonu kullanın.

---

API’ler

kodine sunucusu aşağıdaki API’leri sunar.

---

Global

Yöntem	Yol	Açıklama	Yanıt
GET	/global/health	Sunucu sağlığını ve sürümünü verir	{ healthy: true, version: string }
GET	/global/event	Küresel olayları verir (SSE akışı)	Olay akışı

---

Proje

Yöntem	Yol	Açıklama	Yanıt
GET	/project	Tüm projeleri listeler	Project[]
GET	/project/current	Geçerli projeyi verir	Project

---

Yol & VCS

Yöntem	Yol	Açıklama	Yanıt
GET	/path	Geçerli yolu verir	Path
GET	/vcs	Geçerli projenin VCS bilgisini verir	VcsInfo

---

Örnek (Instance)

Yöntem	Yol	Açıklama	Yanıt
POST	/instance/dispose	Geçerli örneği (instance) kapatır	boolean

---

Config

Yöntem	Yol	Açıklama	Yanıt
GET	/config	Yapılandırma bilgisini verir	Config
PATCH	/config	Yapılandırmayı günceller	Config
GET	/config/providers	Sağlayıcıları ve varsayılan modelleri listeler	{ providers: Provider[], default: { [key: string]: string } }

---

Sağlayıcı (Provider)

Yöntem	Yol	Açıklama	Yanıt
GET	/provider	Tüm sağlayıcıları listeler	{ all: Provider[], default: {...}, connected: string[] }
GET	/provider/auth	Sağlayıcı kimlik doğrulama yöntemlerini verir	{ [providerID: string]: ProviderAuthMethod[] }
POST	/provider/{id}/oauth/authorize	Bir sağlayıcıyı OAuth ile yetkilendirir	ProviderAuthAuthorization
POST	/provider/{id}/oauth/callback	Bir sağlayıcının OAuth geri çağrısını işler	boolean

---

Oturumlar (Sessions)

Yöntem	Yol	Açıklama	Notlar
GET	/session	Tüm oturumları listeler	Session[] döndürür
POST	/session	Yeni oturum oluşturur	gövde: { parentID?, title? }, Session döndürür
GET	/session/status	Tüm oturumların durumunu verir	{ [sessionID: string]: SessionStatus } döndürür
GET	/session/:id	Oturum ayrıntılarını verir	Session döndürür
DELETE	/session/:id	Bir oturumu ve tüm verilerini siler	boolean döndürür
PATCH	/session/:id	Oturum özelliklerini günceller	gövde: { title? }, Session döndürür
GET	/session/:id/children	Bir oturumun alt oturumlarını verir	Session[] döndürür
GET	/session/:id/todo	Bir oturumun yapılacaklar listesini verir	Todo[] döndürür
POST	/session/:id/init	Uygulamayı analiz edip AGENTS.md oluşturur	gövde: { messageID, providerID, modelID }, boolean döndürür
POST	/session/:id/fork	Mevcut bir oturumu bir mesajdan çatallar	gövde: { messageID? }, Session döndürür
POST	/session/:id/abort	Çalışan bir oturumu iptal eder	boolean döndürür
POST	/session/:id/share	Bir oturumu paylaşır	Session döndürür
DELETE	/session/:id/share	Bir oturumun paylaşımını kaldırır	Session döndürür
GET	/session/:id/diff	Bu oturumun farkını (diff) verir	sorgu: messageID?, FileDiff[] döndürür
POST	/session/:id/summarize	Oturumu özetler	gövde: { providerID, modelID }, boolean döndürür
POST	/session/:id/revert	Bir mesajı geri alır	gövde: { messageID, partID? }, boolean döndürür
POST	/session/:id/unrevert	Geri alınan tüm mesajları geri yükler	boolean döndürür
POST	/session/:id/permissions/:permissionID	Bir izin isteğine yanıt verir	gövde: { response, remember? }, boolean döndürür

---

Mesajlar

Yöntem	Yol	Açıklama	Notlar
GET	/session/:id/message	Bir oturumdaki mesajları listeler	sorgu: limit?, { info: Message, parts: Part[]}[] döndürür
POST	/session/:id/message	Mesaj gönderip yanıt bekler	gövde: { messageID?, model?, agent?, noReply?, system?, tools?, parts }, { info: Message, parts: Part[]} döndürür
GET	/session/:id/message/:messageID	Mesaj ayrıntılarını verir	{ info: Message, parts: Part[]} döndürür
POST	/session/:id/prompt_async	Eşzamansız mesaj gönderir (beklemez)	gövde: /session/:id/message ile aynı, 204 No Content döndürür
POST	/session/:id/command	Bir eğik çizgi (slash) komutu çalıştırır	gövde: { messageID?, agent?, model?, command, arguments }, { info: Message, parts: Part[]} döndürür
POST	/session/:id/shell	Bir kabuk komutu çalıştırır	gövde: { agent, model?, command }, { info: Message, parts: Part[]} döndürür

---

Komutlar

Yöntem	Yol	Açıklama	Yanıt
GET	/command	Tüm komutları listeler	Command[]

---

Dosyalar

Yöntem	Yol	Açıklama	Yanıt
GET	/find?pattern=<pat>	Dosyalarda metin arar	path, lines, line_number, absolute_offset, submatches içeren eşleşme nesneleri dizisi
GET	/find/file?query=<q>	Dosya ve dizinleri ada göre bulur	string[] (yollar)
GET	/find/symbol?query=<q>	Çalışma alanı sembollerini bulur	Symbol[]
GET	/file?path=<path>	Dosya ve dizinleri listeler	FileNode[]
GET	/file/content?path=<p>	Bir dosyayı okur	FileContent
GET	/file/status	İzlenen dosyaların durumunu verir	File[]

/find/file sorgu parametreleri

• query (zorunlu) - arama metni (bulanık eşleşme)
• type (isteğe bağlı) - sonuçları "file" veya "directory" ile sınırlar
• directory (isteğe bağlı) - arama için proje kökünü ezer
• limit (isteğe bağlı) - en fazla sonuç sayısı (1-200)
• dirs (isteğe bağlı) - eski bayrak ("false" yalnızca dosya döndürür)

---

Araçlar (Deneysel)

Yöntem	Yol	Açıklama	Yanıt
GET	/experimental/tool/ids	Tüm araç kimliklerini listeler	ToolIDs
GET	/experimental/tool?provider=<p>&model=<m>	Bir modelin araçlarını JSON şemalarıyla listeler	ToolList

---

LSP, Biçimlendiriciler & MCP

Yöntem	Yol	Açıklama	Yanıt
GET	/lsp	LSP sunucu durumunu verir	LSPStatus[]
GET	/formatter	Biçimlendirici durumunu verir	FormatterStatus[]
GET	/mcp	MCP sunucu durumunu verir	{ [name: string]: MCPStatus }
POST	/mcp	Dinamik olarak MCP sunucusu ekler	gövde: { name, config }, MCP durum nesnesi döndürür

---

Agent’lar

Yöntem	Yol	Açıklama	Yanıt
GET	/agent	Mevcut tüm agent’ları listeler	Agent[]

---

Günlük (Logging)

Yöntem	Yol	Açıklama	Yanıt
POST	/log	Günlük girdisi yazar. Gövde: { service, level, message, extra? }	boolean

---

TUI

Yöntem	Yol	Açıklama	Yanıt
POST	/tui/append-prompt	İsteme metin ekler	boolean
POST	/tui/open-help	Yardım penceresini açar	boolean
POST	/tui/open-sessions	Oturum seçiciyi açar	boolean
POST	/tui/open-themes	Tema seçiciyi açar	boolean
POST	/tui/open-models	Model seçiciyi açar	boolean
POST	/tui/submit-prompt	Mevcut istemi gönderir	boolean
POST	/tui/clear-prompt	İstemi temizler	boolean
POST	/tui/execute-command	Bir komut çalıştırır ({ command })	boolean
POST	/tui/show-toast	Toast bildirimi gösterir ({ title?, message, variant })	boolean
GET	/tui/control/next	Sonraki kontrol isteğini bekler	Kontrol isteği nesnesi
POST	/tui/control/response	Bir kontrol isteğine yanıt verir ({ body })	boolean

---

Kimlik Doğrulama (Auth)

Yöntem	Yol	Açıklama	Yanıt
PUT	/auth/:id	Kimlik bilgilerini ayarlar. Gövde sağlayıcı şemasıyla eşleşmelidir	boolean

---

Olaylar (Events)

Yöntem	Yol	Açıklama	Yanıt
GET	/event	Sunucunun gönderdiği olay akışı (SSE). İlk olay server.connected, ardından veri yolu olayları gelir	Sunucu tarafından gönderilen olay akışı

---

Dokümanlar (Docs)

Yöntem	Yol	Açıklama	Yanıt
GET	/doc	OpenAPI 3.1 spesifikasyonu	OpenAPI spec içeren HTML sayfası