AI ajanlarıyla çalışma

Zshell otomasyonu öncelikle AI kodlama ajanları içindir. Onlara bölmelerle çalışma ve diğer ajanları koordine etme olanağını güvenli biçimde verir; öğrenmeniz gereken başka bir komut dili değildir.

AI entegrasyonu varsayılan olarak açıktır. Ajanınızla normal biçimde konuşun. Kullandığınız bölmenin odağını almadan arka plan bölmesi oluşturabilir, bir çalışan ajana iş devredebilir, komut çalıştırabilir, sonucu bekleyip size getirebilir.

Komut sonuçlarını beklemeBağlantıyı kopyala

Test veya derleme gibi sona eren komutlarda ajanınız komutun kendi çıkış kodunu ve süresini bekleyip kaydedilen son terminal çıktısını okuyabilir. Bekleme süresi dolarsa komut çalışmaya devam eder ve odak değişmeden aynı görev yeniden beklenebilir. Zshell’in başlattığı özgün yerel zsh içinde boş bir istem gerekir; iç içe kabuklar, SSH ve özel başlangıç programları desteklenmez. Son çıktı sınırlıdır ve önceki komutları veya istemleri içerebilir. Tam kayıt gerektiğinde ajandan çıktıyı bir dosyaya kaydetmesini isteyin.

Özgün kabuğu sonlandıran veya değiştiren doğrudan exit, logout ve exec çağrıları reddedilir; bunları alt süreçte çalıştırmak için /bin/sh -c kullanın.

KurulumBağlantıyı kopyala

Ayarlar → Otomasyon → AI seçeneğini kontrol edin. Varsayılan açık; önceden kapattıysanız açıp yeni terminal başlatın veya çalışan ajanı yeniden başlatın.

Zshell, Codex, Claude Code, Gemini CLI, Grok Build, OpenCode, Cursor Agent, Aider, Amp ve Pi’yi destekler. Mevcut ajan kurulumu bu özellik ile çakışıyorsa Zshell o kuruluma dokunmaz, anahtarı önceki durumuna döndürür ve Ayarlar’da hata gösterir.

Doğal dille isteyinBağlantıyı kopyala

Ajanınıza istediğiniz sonucu söyleyin. Örneğin:

İlgili testleri arka plan bölmesinde çalıştır ve başarısız olanları söyle.

Bu hatayı başka bir Codex ajanına devret, ardından sonucunu incele.

API üzerinde çalışan ajana şemanın hazır olup olmadığını sor, yanıtı testleri çalıştıran ajana ilet.

Geliştirme sunucusunu yanımızda başlat, hazır olmasını bekle ve URL’yi ver.

Arka plan ajanının bitirip bitirmediğini kontrol et. Takıldıysa neye ihtiyacı olduğunu söyle.

Ajan sizin adınıza Zshell otomasyon arayüzünü kullanır. Otomasyon komutu yazmanız veya ezberlemeniz gerekmez.

Bölmeler arasında ajan koordinasyonuBağlantıyı kopyala

İlişkili işleri birden çok bölmeye ayırıp ana ajanınızdan koordine etmesini isteyebilirsiniz. Örneğin bir ajan API üzerinde çalışırken diğeri testleri günceller. Koordinatör belirli çalışanın bulgularını sorabilir, takip mesajı gönderebilir, faydalı sonucu diğerine iletebilir ve birleşik yanıtı size getirebilir. Çalışanlar desteklenen farklı kodlama araçlarını kullanabilir.

Böylece paralel işte kopyalama/yapıştırma adımı kalkar. Her ajan kendi konuşmasını kendi bölmesinde tutar; koordinatör yalnızca diğerinin ihtiyaç duyduğu soruyu, güncellemeyi veya sonucu iletir.

Takip mesajı göndermek işin bittiği anlamına gelmez. Koordinatör çalışanı bekler, sonucunu okur ve çıktıyı kontrol eder. Başka ajandan gelen mesaj sizin onayınız sayılmaz. İzinler, kimlik bilgileri, güven kararları ve yıkıcı işlemler yine size gelir.

Çalışırken işinize devam edinBağlantıyı kopyala

Görmek istemedikçe devredilmiş bölmeler arka planda kalır. Sağlayıcının yerel yaşam döngüsü entegrasyonu durum bildirirse Zshell bunu ajan bölmesinde ve sekmesinde gösterir:

Zshell önce Codex, Claude Code, Pi, OpenCode ve Grok’un yerel olaylarını, ardından programların açık bildirimlerini kullanır. Kaynak, bekleme nedeni, yüzde ve alt görevleri görmek için durum rozetinin üzerine gelin veya Agents bölümünü açın. Codex kancaları önce /hooks menüsünde incelenip güvenilir olarak işaretlenmelidir; Zshell bunu atlamaz.

Yerel bildirim yoksa yalnızca tanınan Agent sürecinin güncel ekranının alt kısmı sınırlı olarak incelenir. Ekrandan çıkarım etiketlenir; tamamlanma bildirmez, bildirim göndermez, zshell +agent wait koşulunu karşılamaz ve onay vermez. Bölmeyi ve gerçek sonucu inceleyin.

Programlar zshell +agent report ile ilerleme bildirir, zshell +agent clear ile kendi bildirimini temizler. Bildirim 120 saniye güncellenmezse veya sahibi olan süreç sonlanırsa geçersiz olur.

Entegrasyon bitiş veya girdi gereksinimi bildirince Zshell bildirim de gönderebilir. Dikkatinizi gerektirdiği raporlanan sonraki ajana geçmek için Cmd+Shift+A kullanın.

Hesap kullanımı ve sınırlarBağlantıyı kopyala

Ayarlar → Otomasyon → Hesap Kullanımı, Claude Code ve Codex’in erişilebilir hesap sınırlarını; kullanılan yüzdeyi, raporlanmışsa sıfırlama zamanını ve son güncelleme zamanını gösterir. Güncel veriyi almak için Kullanımı Yenile kullanın.

Codex, kurulu, giriş yapılmış ve hesap sınırlarını raporlayabilen CLI gerektirir. Claude Code kullanımı, Zshell sağlayıcıdan durum satırı kullanım raporu aldığında görünür. Bölüm yalnızca veri varsa görünür; desteklenen zaman aralıkları sağlayıcı ve hesaba bağlıdır. Bunlar odaktaki oturumun token toplamı değil, hesap sınırlarıdır.

Tipik iş akışıBağlantıyı kopyala

1. Her zamanki kodlama ajanınızı Zshell terminalinde başlatın.
2. Sınırları belli bir görev devretmesini, arka planda bir şey çalıştırmasını veya başka ajanı koordine etmesini isteyin.
3. Zshell devredilen işi proje düzeninde görünür tutarken mevcut bölmenizde çalışın.
4. Varsa sağlayıcının bildirdiği Çalışıyor, Engellendi veya Tamamlandı rozetini izleyin. Araç yaşam döngüsü raporlamıyorsa konuşmayı veya terminal çıktısını incelemek için bölmeyi açın.
5. Sonuç dosyalarını Git panelinde ve fark görünümünde inceleyip nelerin kalacağına karar verin.

Kontrol sizdeBağlantıyı kopyala

• Ajan otomasyonu mevcut Zshell projesiyle sınırlıdır; başka proje veya pencerenin bölmelerine erişemez.
• Açıkça istemedikçe arka plan işi odağı almaz.
• Zshell izin, kimlik bilgisi, güven veya yıkıcı işlem sorularını sizin adınıza yanıtlamaz. Sağlayıcının engellenmiş bildirdiği ajan kararı size bırakır.
• Tamamlanma bildirimi sonucu inceleme işaretidir; değişikliklerin otomatik onayı değildir.

Ajan Zshell’i kullanmıyorsaBağlantıyı kopyala

• Ayarlar → Otomasyon → AI seçeneğinin açık olduğunu doğrulayın.
• Mevcut terminal ayarı açmanızdan önce oluşturulduysa yeni terminal açın.
• Ayarı açtığınızda zaten çalışan ajanı yeniden başlatın.
• Ayarlar’da satır içi kurulum hatası olup olmadığını kontrol edin.
• Bu akışı istediğiniz görevde açıkça “arka plan Zshell bölmesi” veya “devredilmiş Zshell ajanı” isteyin.

Özgün konuşmayı sürdürmeBağlantıyı kopyala

Ajan konuşmalarını sürdür açıkken özgün PTY kullanılamayan bölme, kaydedilmiş Claude Code, Codex, Pi veya OpenCode konuşmasını sürdürür. Aynı dizindeki bölmeler kendi ayrı konuşmalarını korur.

Zshell mevcut sağlayıcı yapılandırmasına Claude Code ve Codex için SessionStart kancaları, Pi uzantısı ve OpenCode TUI eklentisi kurar. Diğer kancalar, eklentiler, ayarlar ve JSONC yorumları korunur. Sağlayıcı istediğinde Claude Code güven sorusunda kancaları etkinleştirin ve Codex’in /hooks bölümünde yeni kancaları onaylayın. Kurulumdan önce çalışan ajanları yeniden başlatın.

Yalnızca bu entegrasyonların bildirdiği doğrulanmış ana konuşmalar sürdürülür. Doğrulanmış bir konuşma kimliği bölmeyle eşleştiğinde paylaşılan Codex app-server oturumları desteklenir; belirsiz eşleşmeler bağlanmaz. Uzak ana makinelerdeki konuşmalar için paylaşılan uzak oturumlara bakın. OpenCode TUI eklenti API’si gerektirir; eski sürümler, arayüzsüz sunucu oturumları ve opencode attach desteklenmez. Alt ajan üst bölmenin konuşmasını değiştiremez. Pi kayıtlı oturum dosyasını gerektirir.

Doğrulanmış kimlik, özgün çalışma dizini veya Pi dosyası yoksa yeni kabuk açılır. CLI bulunamazsa da kabuğa dönülür. Zshell rastgele başlangıç komutunu yinelemez ve son konuşmayı seçmez. Silinmiş konuşma gibi sağlayıcı hatalarını CLI gösterir.

Kaydedilmiş konuşmaları bulma ve sürdürmeBağlantıyı kopyala

Aracılar → Ajan Konuşma Geçmişi menüsünü, proje kenar çubuğunun üstündeki saati açın. Projeler arasında başlık, sağlayıcı, proje, konuşma ID’si, çalışma veya yapılandırma diziniyle arayın. Zshell, ajanlar ve bölmeler kapandıktan ve uygulama yeniden başladıktan sonra en yeni 200 doğrulanmış yerel konuşmayı tutar. Son arşivlenmemiş 20 eşleşmeyi, Tümü arşiv dahil tüm kayıtları, Arşivlenen yalnızca arşivi gösterir.

Açık konuşma için Konuşmayı göster, kayıtlı konuşma için Konuşmayı sürdür seçin. Zshell açık bölmeyi kullanır, çalışan PTY’ye yeniden bağlanır veya sağlayıcının tam olarak o konuşmasını özgün dizin ve yapılandırmasıyla sürdürür. Elle sürdürme, otomatik geri yükleme kapalı olsa da AI entegrasyonunu gerektirir. Eksik dizinler ve eksik veya eşleşmeyen Pi dosyaları yeni bölme açılmadan hata gösterir.

Arşivle kaydı Son listesinden gizler; Arşivden çıkar geri getirir. Sil… yalnızca Zshell kaydını kaldırır ve sağlayıcının konuşma dosyalarını korur.

Zshell bölmesinde zshell +agent history --all ve zshell +agent resume --id HISTORY_UUID o bölmenin projesiyle sınırlıdır. Sıradan bir dış terminalden Zshell’i açık tutun, proje UUID’sini bulun ve açıkça seçin:

zshell +agent history projects
zshell +agent history --project PROJECT_UUID --all
zshell +agent resume --project PROJECT_UUID --id HISTORY_UUID --focus

CLI, --focus eklenmedikçe arka planda sürdürür. Proje birkaç pencerede açıksa history projects çıktısından --window WINDOW_UUID seçin. Birkaç uygulama örneği çalışıyorsa CLI’ın belirttiği özel bağlantı dosyasının mutlak yoluyla --connection PATH kullanın. Bu hedef seçenekleri dış terminallere aittir; bölme süreçleri özgün proje kapsamını korur.

Canlı proje olaylarını izlemeBağlantıyı kopyala

Zshell terminalinde zshell +events, terminalin projesi ve penceresindeki sonraki değişiklikleri yoklama yapmadan NDJSON olarak izler. Seçenekler: --pane UUID, yinelenebilir --event NAME, --once ve --timeout MS (0 süresiz bekler).

Oturum ve bölme oluşturma/kapatma, odak, agent ilerlemesi, dikkat isteği ve bitişi ile komut bitişi bildirilir. stream.ready, sequence 0 ile başlar; eşleşen her olay sıra numarasını artırır. Her satır version, event, stream_id, sequence, Unix milisaniyesi time, project_id ve data içerir. Geçmiş yeniden gönderilmez. Sonuçları +pane wait --task UUID ile okuyun.

Sınırlar: 32 abonelik, kuyruk başına 256 kare ve 1 MiB, kare başına 64 KiB. Yavaş okuyucuya mümkünse stream.lagged gönderilip bağlantı kesilir; 2 saniye yazılamayan bağlantı da kapanır. Gecikme, beklenmeyen kopma veya sıra hatası sıfırdan farklı çıkış verir. Yeniden abone olup güncel durumu okuyun. Terminali kapatma, token yenileme veya başka proje/pencereye taşıma aboneliği bitirir. Dış denetim ve --project desteklenmez; ortam değişkenlerini silmek yetkiyi artırmaz. --once eşleşmeden zaman aşımında 124, normal zaman aşımında 0 döner.

zshell +events --event command.task.finished --once --timeout 30000

pane.updated: data.from → data (tab_id, pane_id, terminal_id, content).