kule run

Bir ajana bir istem (prompt) verir. Ajan görevin kopyasında, sandbox (yalıtılmış ortam) içinde, ağ trafiği görevin proxy'sinden geçerek çalışır. Siz commit edene kadar çalışma klasörüne hiçbir şey ulaşmaz.

Kullanım

kule run [OPTIONS] <TASK> <PROMPT>

Açıklama

kule run, Claude Code, Codex ya da Gemini gibi bir ajanı başlatır, ona prompt'unuzu verir ve sırası bitene kadar yaptıklarını yazdırır. Kule ajanla, bir editörün yapacağı gibi Agent Client Protocol (ACP) üzerinden konuşur.

Ajanın yapabilecekleri:

• Dosyalar: görevin kopyasını okur ve yazar. Gerçek klasörünüze yazamaz; kimlik bilgilerinizi (~/.ssh, ~/.aws, …), kendi klasörlerinizi (Documents, Desktop, …) ya da diğer ajanların oturum bilgilerini okuyamaz. Bkz. Sandbox.
• Ağ: her bağlantı görevin proxy'sinden geçer. Paket depoları ve ajanın kendi model API'si geçer; geri kalan her şeye politika karar verir. CLI'da soracak kimse olmadığından, politikanın bir insana soracağı bir bağlantı hemen reddedilir. (Uygulamada sizin cevabınızı bekler.) Bkz. Ağ ve sorular.
• Ev dizininiz: ~/.zshrc, ~/.config ve benzerlerine yazdıkları, kule home ile incelemeniz için görevin ev katmanında (home layer) yakalanır; kendiliğinden asla ev dizininize yazılmaz.
• Gizli değerler: yer tutucuları görür, API anahtarlarınızı asla görmez. Bkz. Gizli değerler.

Ajanın dosya değiştiren her araç çağrısı bir adım olur (bkz. kule steps). Çalıştırma bittiğinde Kule kopyada neyin değiştiğini ve politikanın bunun hakkında ne dediğini yazdırır; böylece doğrudan kule commit ya da kule rollback komutuna geçebilirsiniz. Önce ajanı yeniden de çalıştırabilirsiniz: siz karar verene kadar değişiklikler kopyada birikir.

Bütçeler ve sınırlar geçerlidir. Görevin bütçelerinden biri (kendi bütçesi, grubununki ya da tüm görevler için olan günlük bütçe) tükendiğinde ya da görev süresini doldurduğunda çalıştırma başlamaz. Çalışırken işlemci, bellek, disk, süre ve boşta kalma sınırları, uygulamada olduğu gibi onu tutar.

Ajan neyin değiştiğini duyar. Ajanın son çalıştırmasından bu yana kule sync klasördeki değişiklikleri kopyaya aldıysa ya da sandbox ona Kule'nin açıklayabildiği bir şeyi reddettiyse, prompt'unuzdan önce Kule'nin kendi sözleriyle kısa bir not bir kez gider.

Bir görevde aynı anda tek bir ajan çalışır. Ajanları yan yana çalıştırmak için daha fazla görev açın (aynı klasörde ya da başkalarında).

not

Ajanın, Kule olmadan nasıl kuruluyor ve oturum açıyorsa öyle kurulmuş ve oturum açmış olması gerekir: Claude Code ve Codex Node.js (npx), Gemini kendi CLI'ını ister. kule agents, burada hangi ajanların başlayabildiğini ve diğerlerinin neden başlayamadığını listeler. Bkz. Ajanlar.

Argümanlar

Ad	Zorunlu	Anlamı
TASK	evet	Görevin tam kimliği. Bkz. Bir göreve atıf yapmak.
PROMPT	evet	Ajanın ne yapması gerektiği. Tırnak içine alın: tek bir argüman olmalı.

Seçenekler

Seçenek	Değer	Varsayılan	Anlamı
--agent	ad	claude-code	Prompt'u hangi ajanın alacağı: claude-code, codex, gemini ya da eklediğiniz ve onayladığınız bir ajan profilinin adı (bkz. kule agents).
--home	yol	~/.kule	Kule'nin ev klasörü (KULE_HOME ile de verilebilir). Bkz. genel seçenekler.

Örnekler

Claude Code'dan bir testi düzeltmesini istemek:

kule run 3422f830 "The test in tests/greet.rs fails. Fix it and run cargo test."

Onun yerine Codex kullanmak:

kule run 3422f830 --agent codex "Add a --verbose flag to the CLI."

Kod yerine belgeler üzerinde çalışmak:

kule run 40ac70b8 "Sort the notes in this folder into one folder per year. Keep the file names."

Çalıştırmak, kararı kontrol etmek ve yalnızca her şey kendiliğinden geçiyorsa commit etmek:

kule run "$TASK" "Update the README's install section" && kule commit "$TASK"

Onayınızı bekleyen herhangi bir şey varsa kule commit 3 ile çıkar ve hiçbir şey commit etmez; bu yüzden bu güvenlidir.

Çıktı

Ajan çalışırken bir meşgul satırı ne yaptığını söyler. Bir çalıştırmanın çıktısı şuna benzer (ajanın sözleri ve araçları değişir):

I'll look at the failing test first.

  ✓ Read tests/greet.rs → step 1: no file changes
  ✓ Edit src/main.rs → step 2: src/main.rs
  ✓ cargo test → step 3: target/debug/app and 41 more
plan: Read the test / Fix greet / Run the tests

The greeting now matches what the test expects, and cargo test passes.

1 file changes: +0 ~1 -0
  ~ src/main.rs
      ~ function greet
net: index.crates.io:443 · tunneled (package-registries)
policy: passes on its own
spent: 0.12 USD, 18234 tokens in 1 run
took: 41s

Satır	Anlamı
düz metin	Ajanın cevabı, yazdığı gibi.
✓ <tool> → step N: <files>	Başarılı bir araç çağrısı, dönüştüğü adım ve değiştirdiği dosyalar (ilk beşi; geri kalanı kule steps'te). ✗ başarısız olduğu anlamına gelir.
plan:	Ajan paylaşırsa planı.
· <note>	Kule'den ya da ajandan bir not; örneğin ona verilen bir izin.
N file changes: +a ~m -d	Kopyada olup çalışma klasöründe olmayanlar: oluşturulan, değiştirilen, silinen. Her dosyanın içinde değişen fonksiyonlar, bölümler ya da anahtarlar. Bkz. kule status.
git:	Depoya ne olduğu: dal hareketleri, yeni nesneler, config ya da hook değişiklikleri. Bkz. Git.
net:	Çalıştırmanın yaptığı her bağlantı ve geçip geçmediği.
in your home, caught for review	Ev klasörünüze yapılan ve ev katmanında bekleyen yazmalar. Bkz. kule home.
sandbox: refused …	Sandbox'ın reddettikleri (macOS bunları listeler; Linux'ta komut yalnızca bir hata alır).
policy:	Değişiklikler hakkındaki karar: passes on its own (kendiliğinden geçer), waits for approval (onay bekler) ya da denied (reddedildi), her birinin arkasındaki kuralla birlikte.
spent:	Görevin çalıştırmalarının, ajanların bildirdiğine göre, şimdiye kadar ne kadar tuttuğu ve bütçesinden ne kaldığı.
took:	Çalıştırmanın ne kadar sürdüğü.

Çıktı bir terminal değilse her olay kendi düz satırında yazılır; bu, günlüğe kaydetmeyi kolaylaştırır.

Hatalar ve çözümleri

Mesaj	Ne yapmalı
kule: no agent <name>; known: claude-code, gemini, codex	Adı kontrol edin. Kendi ajanlarınızı kule agents ile ekleyin.
kule: agent <name> cannot run: <why>	Ajan eksik, oturum açılmamış ya da (kendi profilleriniz için) henüz onaylanmamış. Nedenini görmek için kule agents çalıştırın.
kule: task <id> has spent its budget; raise it or turn it off to run again	kule budget TASK <amount> ile artırın ya da kule budget TASK off ile kapatın. Tükenen bir grubun ya da günlük bütçeyse mesaj onun adını verir.
kule: the task has used its time: its runs took N minutes together; …	Görevin süre sınırını kule limits ile artırın ya da kaldırın.
kule: an agent is at work in task <id> …	Görev başına tek ajan. Bekleyin ya da başka bir görev açın.
kule: <error> (see <home>/tasks/<id>/agent.log)	Ajan başarısız oldu. Kendi mesajları agent.log içinde.
kule: <agent> reported no cost, so the task's budget does not count this run	Hata değil, bir uyarı: abonelikle oturum açmış ajanlar yalnızca token bildirebilir ve bütçe, bildirilmeyeni tutamaz.

Bazı Linux sistemlerinde, daha zayıf yalıtımı kabul edene kadar hiçbir ajan çalışmaz; bkz. kule isolation.

Uygulamada

Prompt'u Agent panelinde yazın (Mod+L imleci oraya koyar), altından ajanı seçin ve Enter'a ya da Run'a basın. Uygulama ayrıca her araç çağrısının çıktısını akarken gösterir, ajanın sorularını cevaplamanızı sağlar ve bir Stop düğmesi (Mod+Shift+K) sunar. Bkz. Live.

Ayrıca bakın

• kule exec: ajan yerine sandbox içinde tek bir komut çalıştırmak.
• kule steps, kule status, kule commit
• Ajanlar, Bütçeler ve sınırlar