Çalıştırma ve bakım

Başlatma ve durdurma

kortext sunucuyu arka planda başlatır ve paneli açar. Terminal penceresi kapatılabilir; panel çalışmaya devam eder. Durdurduktan sonra yeniden başlatmak için kortext'i yine çalıştırın.

kortext              # arka planda başlat, paneli aç
kortext --stop       # arka plan sunucusunu durdur
kortext --no-detach  # bu terminalde tut, Ctrl+C ile durdur

Ne ⏻ düğmesi ne de --stop koşan bir adımı yarıda keser: biri sürerken reddederler, böylece bir analiz yazımın ortasında kesilmez.

Komut satırı

kortext [--port 3441] [--db ~/.kortext/kortext.db] [--no-open] [--no-detach]
kortext --stop
kortext --version
kortext --help

--no-open sunucuyu tarayıcı açmadan başlatır. --stop, --port'taki sunucuyla konuşur; 3441 değilse başlattığınız portu verin.

Bir projeyi yönetmek

• Pause yeni adımların başlamasını durdurur; koşan adım da durdurulur.
• Continue zinciri kaldığı yerden alır. Adım koşarken görülene kadar tutar, böylece ikinci bir basış onu yeniden duraklatmaz. Başka yerden — menü çubuğu uygulaması, başka bir sekme — yapılan duraklatma panele ulaşır.

Gerisi projenin adının yanındaki ⚙'nin arkasında durur. Basın; yolun altında açılırlar, her biri yerinde kurulur ve harekete geçmeden önce bir kez daha sorar:

• Restart analiz belgelerini ve hazırlık sonucunu temizler; BRIEF.md'yi onay durumu dahil olduğu gibi korur. Proje duraklatılmış gelir; hazır olunca Start'a basın. .kopeng/'e dokunulmaz.
• Archive bitmiş bir projeyi rafa kaldırır. Satır kalır, depoya dokunulmaz.
• Export documents yazılmış her belgeyi bir onay kutusuyla listeler — All, None ya da seçin — ve seçilenleri tek zip olarak indirir. .kortext/ gizli bir klasördür; dosya seçici göstermez; belgeler başka bir araca böyle ulaşır.
• Remove Kortext'in analizini siler — brief'iniz ve içindeki elle düzenlemeler dahil .kortext/ klasörünün tamamı, AGENTS.md'deki bloğu, CLAUDE.md'deki işaret satırı ve projenin logları — sonra projeyi listeden çıkarır.

Remove brief'inizi siler

Remove, BRIEF.md dahil .kortext/'i tamamen siler. .kopeng/ ve diğer proje dosyaları kalır; AGENTS.md ve CLAUDE.md'deki kendi içeriğiniz de kalır. İki aracı da kaldırmaz. Projeyi yalnızca listeden çıkarmak istiyorsanız Archive kullanın.

Motoru, modeli ve eforu değiştirmek

Start'ın yanındaki satır projeyi neyin koşturduğunu söyler — claude · sonnet · high ›. Basın, motor seçici açılır: Add project formundakiyle aynı.

CLI — claude, codex, antigravity, gemini ve listedeki diğerleri; çipler neyin kurulu olduğunu gösterir. Motor Kortext'e değil projeye aittir. Bir kota bittiğinde yapılacak hamle değiştirmektir: sonra başlayan adımlar öteki CLI'da koşar, o anda koşan ne varsa eskisinde biter.

Model — default CLI'ın kendi ayarını kullanır. Birini seçin; her koşuda CLI'a geçirilir (claude --model, codex -m, agy --model). Liste CLI'ın kendi listesidir, her biri hakkında bir satırla; listede olmayan bir ad CLI kabul ediyorsa yine çalışır.

Efor — bu kavrama sahip CLI'lar için: claude --effort, codex'in model_reasoning_effort'u, agy --effort, o CLI'ın kendi seçicisinin sunduğu düzeylerle. Model gibi, ayarladıktan sonra başlayan koşulara ulaşır; sonraki CLI'ın almadığı bir düzey geçişte düşer.

Her seçim anında kaydedilir. El sıkışmadan sonra satır ve denetimleri gider — Kortext o projeden emekli olmuştur.

İki proje iki farklı CLI üzerinde durabilir, biri ötekini rahatsız etmez. Bir projenin kullandığı CLI'ı kaldırırsanız o proje durmaz — hâlâ kurulu olan CLI'a düşer ve motor satırı neye düştüğünü gösterir.

Panelin kendi denetimleri

Durum çubuğu, altta. İlk satır neyin koştuğunu söyler — Stable version 3.1.2 ya da Beta version 3.2-beta4 — ve ⏻ düğmesi: sunucu ayaktayken yeşil, durunca kırmızı, kortext'i yeniden başlattığınızda kendiliğinden yine yeşil. Durdurmak iki tık ister — ilki kurar ve söyler, ikincisi sunucuyu durdurur — ve bir belge yazılırken asla. Güncelleme denetimi için sürüme basın: up to date ya da alttaki şerit. İkinci satır öteki kanalı sunar — Try beta version ya da geri dönmek için Use stable version; basınca kurulur ve şerit devralır.

Güncelleme şeridi, iki ekranın da başlığının altında, mavi, yalnızca npm sizin kanalınızda daha yeni bir sürüm taşıdığında görünür. Panel açıldığında bir kez, sonra her saat bakar; böylece açık dururken bir sürüm düşer. Update now kurulumu sizin için çalıştırır; o sırada sunucuya yapılan her başka çağrı reddedilir. Sonra şerit Quit sunar — basın, kortext'i yeniden başlatın, yeni sürüm devralır. Kurulum başarısız olursa şerit bunu söyler ve kendinizin çalıştıracağı komutu verir.

Menü çubuğu uygulaması çalışmayan bir Mac'te aynı yuva onun yerine Download for macOS sunar — bir seferde tek şerit.

Tema. Başlığın sağındaki düğme auto → light → dark döner. Auto işletim sistemini izler; diğer ikisi bu tarayıcıda hatırlanır.

İçeri uzanan iki URL. /?project=<id> bir projeyi açar; /?project=<id>&doc=<rel> onu bir belgede açar — ?project=1&doc=DESIGN.md. Menü çubuğu uygulaması ve bildirimleri bunları kullanır.

Güncelleme ve kaldırma

npm update -g kortext
npm uninstall -g kortext

Kaldırmak yalnızca ikili dosyayı siler. Kayıt defteri ve loglar ~/.kortext/'te, her belge deponuzda kalır — temiz sayfa istiyorsanız ikisini de kendiniz silin. Menü çubuğu uygulaması ayrı bir kurulum ve ayrı bir kaldırmadır.

Neler nerede

~/.kortext/kortext.db	proje kayıt defteri — tek veri tabanı, her proje
~/.kortext/kortext.db.logs/	her CLI koşusunun ham çıktısı
~/.kortext/kortext.db.log	arka plan sunucusunun bastıkları
<repo>/AGENTS.md	devir teslim sözleşmesi, işaretli bir blok içinde
<repo>/.kortext/	on dört analiz belgesi; yeni projede BRIEF.md de burada, el sıkışmada isterseniz EXPERIENCE.md de gelir
<repo>/.kortext/DESIGN.html	DESIGN.md, çizilmiş

--db /path/name.sqlite ile kayıt defteri /path/name.sqlite, CLI logları /path/name.sqlite.logs/ içinde olur ve arka plan sunucusu /path/name.sqlite.log'a yazar.

Bir şey ters gittiğinde

Bir adım başarısız oldu. Satır nedenini CLI'ın kendi sözcükleriyle söyler. Olağan neden, kurulu ama giriş yapmamış bir ajan CLI'ıdır — bir terminalde bir kez kendi başına çalıştırın, sonra Retry.

Başlık ajan CLI'ı bulunamadı diyor. PATH'inizde desteklenen CLI yok. Birini kurun ve sayfayı yenileyin.

Bir adım uzun süredir koşuyor. Analiz adımları dakikalar sürer; takılan bir adım on beşinci dakikada durdurulur. Brief'in hazırlık değerlendirmesi beşte durur, isteğe bağlı Kopeng planlama koşusunun sınırı otuz dakikadır. Ham CLI çıktısı varsayılan olarak ~/.kortext/kortext.db.logs/ içindedir; özel bir --db ile o veri tabanının yanındadır.

Bir adım koşarken Kortext yeniden başladı. O adım "kortext restarted mid-step — retry" notuyla başarısız işaretlenir; yapılacak tam olarak budur.

Bir belge "Action needed"dan çıkmıyor. Başarısız bir koşu, açık bir soru, karara bağlanmamış giden bir istek, bekleyen gelen bir istek ya da Approve n/a bekleyen bir n/a? var mı bakın. Açık sorular ve karara bağlanmamış istekler onayı engeller. Gelen bir istek tek başına engellemez ama onaylamak onu kapatmaz: belge hâlâ ilgi ister ve istek ele alınmadan analiz bitemez.

Diskteki değişiklikleriniz görünmüyor. Panel birkaç saniyede bir yoklar; bir an verin.

Sorular

API anahtarı gerekiyor mu? Hayır. Kortext kendi adına hiçbir LLM API'sini çağırmaz. PATH'inizdeki ajan CLI'ını çalıştırır ve arkasındaki aboneliği harcar.

Git gerekli mi? Hayır.

Kortext kodumu yazar mı? Hayır. Analiz belgelerini ve AGENTS.md sözleşmesini üretir; kodu, el sıkışmadan sonra, onlara karşı kendi ajanınız yazar.

Verilerim nereye gider? Proje kayıt defteri ~/.kortext/'teki yerel bir SQLite dosyasıdır; belgeler kendi deponuzdaki markdown'dır. Kortext hiçbir yere hiçbir şey göndermez — ajan CLI'ınızın ne yaptığı sizinle o CLI arasındadır.

İki proje farklı CLI kullanabilir mi? Evet. Motor proje başınadır; model ve efor da.

Menü çubuğu uygulaması gerekli mi? Hayır. Aynı sunucuya açılan bir penceredir; ürünün tamamı paneldir. İsterseniz ne yaptığı.

Analiz tamamlandıktan sonra ne olur? Kortext emekli olur. Belgeler o andan itibaren kılavuzdur.