Ayarlar

Ayarlar, uygulamanın tamamını ilgilendiren şeyleri toplar: ajanlarının hangi yapay zeka sağlayıcısını kullandığı, her ajanın neye erişebildiği, neleri hatırladıkları ve verilerinin nasıl saklandığı. Üst bardaki dişli simgesiyle ya da Ctrl+, ile açarsın. Panel sağdan kayarak gelir, Esc kapatır.

Panelde altı bölüm var: Ajanlar, İzin Matrisi, Sağlayıcılar, Hafıza, Veri yönetimi ve Genel.

Ajanlar

Bu bölüm yalnızca kaç ajanın olduğunu gösterir. Ajanlar Organizasyon sayfasında oluşturulur ve düzenlenir: Organizasyonda aç seni Organizasyon → Ajanlar’a götürür. Bkz. Organizasyon.

İzin Matrisi

Dinamik İzin Matrisi, her ajan için bir satır ve her izin için bir anahtar içeren bir tablodur:

İzin	Ne sağlar
Dosya okuma	Proje klasöründeki dosyaları okur ve arar.
Dosya yazma	Dosya oluşturur ve düzenler.
Terminal	Kabukta senin kullanıcı yetkilerinle komut çalıştırır.
Ağ	İnternetten sayfa çeker ve arama yapar.
Tarayıcı	Henüz uygulanmıyor: ajanlar uygulama içi tarayıcıyı kullanamaz.
Onay iste	Her göreve başlamadan önce senin onayını bekler (tüm sağlayıcılarda).

Yollar sütunu, ajanın proje klasörü dışında kullanabileceği ek klasörleri eklemeni sağlar (Klasör ekle). Ek klasörler Claude Code ajanlarında geçerlidir. Nasıl uygulanır? kutusu, anahtarların CLI’ın araç listesine ya da sandbox moduna nasıl çevrildiğini anlatır.

Ajan tablosunun altındaki Bağlantı izinleri, sunucu ve veritabanı erişimini ajan ve bağlantı bazında belirler. Varsayılan: erişim yok. Bağlantıları yönet seni Organizasyon → Bağlantılar’a götürür.

Aynı anahtarlar her ajanın sayfasında, Organizasyon → Ajanlar → İzinler altında da var. İki yer senkron kalır ve değişiklikler anında kaydedilir. Ayrıntılar İzinler ve Bağlantılar sayfalarında.

Uyarı: Terminal izni açık bir ajan, dosya ve ağ kısıtlarını kabuk üzerinden aşabilir. Bu izni yalnızca güvendiğin ajanlara aç.

Sağlayıcılar

Sağlayıcılar, ajanlarının arkasındaki model ve CLI bağlantılarıdır. Listede her sağlayıcı, modeli ve API sağlayıcılarında anahtarın kayıtlı olup olmadığı (anahtar ✓ ya da anahtar yok) görünür. Hiç sağlayıcın yoksa ajanlar demo modunda çalışır.

• Sağlayıcı ekle formu açar. Claude Code CLI, Codex CLI, Anthropic API, OpenAI API ya da Demo (simülasyon) seçip Kaydet ve test et dersin.
• CLI’larda form ● kurulu ya da ○ bulunamadı gösterir. CLI başka bir yerde değilse CLI yolu (boş = PATH’ten bul) alanını boş bırak. Bir kez terminalde claude auth login ya da codex login ile giriş yap.
• API sağlayıcılarında API anahtarını yapıştırırsın. Anahtar işletim sisteminin anahtar zinciriyle şifrelenir ve arayüzde bir daha gösterilmez.
• Model bir açılır listedir ve Önerilen grubunu içerir. API anahtarıyla Hesabındaki diğer modeller de listelenir. Özel model adı… ile listede henüz olmayan bir modeli yazabilirsin.
• Varsayılan yap, kendine ait sağlayıcısı olmayan tüm ajanların kullanacağı sağlayıcıyı seçer. Tek bir ajana başka bir sağlayıcı ve model vermek için Organizasyon → Ajanlar → Model’i kullan.

Her sağlayıcının kurulumu Sağlayıcılar sayfasında.

Hafıza

Kalıcı Hafıza, lider ve ajanların çalışmalar arasında koruduğu bağlamdır. Kapsamı Organizasyon geneli ile Bu proje arasında değiştirirsin, Hafızada ara… ile ararsın, bir kaydı Ortak (tüm ajanlar) ya da Yalnızca tek bir ajan için eklersin ve artık istemediğin kayıtları silersin. Bkz. Hafıza.

Veri yönetimi

Tüm veriler bilgisayarındaki tek bir SQLite dosyasında durur. Bu bölüm ne kadar yer kapladığını gösterir; temizlik, yedek ve sıfırlama buradan yapılır. Klasörü aç veri klasörünü açar.

Kullanım

Kartlar Veritabanı, Ajan logları, Organizasyon hafızası, Yedekler ve Dosyalar için boyutları ve sayıları özetler.

Temizlik

Projeler altında her proje kendi sayılarını gösterir (görev, mesaj, log, hafıza, karar, rapor, dosya). Temizle… ile neyin silineceğini seçersin: Proje hafızası, Sohbet geçmişi, Çalışma kayıtları, Raporlar, Kararlar, Görevler ve Dosyalar. Karar hafızasını koru, kabul edilen kararları hafızada tutar. Bir projeyi temizlemek diğerlerine dokunmaz. Ajanlar, takımlar ve proje klasöründeki dosyalar her zaman korunur.

Çalışma kayıtları ya da Görevler’i seçersen o projede çalışan işler önce durdurulur.

Organizasyon ve kayıtlar altında Organizasyon geneli hafıza da aynı şekilde temizlenir; Kararları koru seçeneği vardır.

Log saklama süresi

Log saklama süresi, 7, 30 ya da 90 günden veya 1 yıldan eski ajan loglarını siler. Varsayılan 30 gündür. Eski loglar açılışta ve 6 saatte bir silinir. Şimdi uygula hemen çalıştırır, Süresiz otomatik silmeyi kapatır. Ajan terminali dökümleri de log olduğu için aynı kurala göre budanır.

Yedekler

Yedek al, veritabanının anlık kopyasını alır: ayarlar, ajanlar, organizasyon, projeler, görevler ve hafıza. Son 10 yedek tutulur, sıfırlamadan önce de otomatik bir yedek alınır. Listedeki her yedeği geri yükleyebilir ya da silebilirsin.

Geri yükle önce mevcut verini yedekler, sonra onu seçtiğin yedekle değiştirir ve uygulamayı yeniden başlatır. Eski sürümlerden kalan yedekler uygulama açılırken yükseltilir. Bozuk ya da daha yeni bir sürümle alınmış yedek reddedilir.

Not: Yedekler yalnızca veritabanını kapsar, proje klasörlerini kapsamaz. Windows’ta yedekteki kayıtlı API anahtarları yalnızca aynı bilgisayardaki aynı kullanıcı tarafından çözülebilir.

Fabrika ayarlarına dön

İki sıfırlama seçeneği de çalışan tüm işleri durdurur, önce yedek alır ve onay için SIFIRLA yazmanı ister.

• Çalışma verisini sil, tüm projelerin görevlerini, sohbetlerini, loglarını, kararlarını, raporlarını, hafızasını ve dosya kayıtlarını siler. Ajanlar, izinler, organizasyon, takımlar, projeler ve klasörleri, sağlayıcılar ve ayarlar korunur.
• Her şeyi sıfırla, uygulamayı ilk kurulduğu hâline döndürür. Ajanlar, organizasyon, projeler, sağlayıcılar ve kayıtlı API anahtarları da silinir. Boş bir organizasyon ve tek boş proje kalır; kurulum sihirbazı ve Kılavuz yeniden açılır.

İki seçenek de proje klasörlerindeki dosyalara ve yedek klasörüne dokunmaz. Yanlışlıkla sıfırladıysan otomatik yedeği Yedekler’den geri yükle.

Genel

Genel, uygulama genelindeki davranışları içerir:

• Proje klasörleri: her projenin kendi klasörü var. Proje ayarlarını aç seni oraya götürür. Bkz. Projeler.
• Açılışta: Proje seçiciyi göster hangi projelerin açılacağını sorar, Son açık projeler son oturumdaki sekmeleri yeniden açar.
• Otopilot: boşta kalan ajanlar sıradaki görevleri kendiliğinden alır.
• Lider incelemesi: biten işler lider tarafından incelenir; onaylanır ya da revizyona döner.
• Kurulum sihirbazı: Yeniden başlat ilk açılış ekranını yeniden gösterir.
• Dil: İngilizce ya da Türkçe. Varsayılan Sistem, işletim sisteminin dilini izler; desteklenmiyorsa İngilizceye geçer. Değişiklik yeniden başlatma gerekmeden hemen uygulanır. Hiç değiştirmediğin varsayılan adlar (ör. kökteki “Organizasyon”) yeni dile çevrilir. Daha önce kaydedilmiş mesajlar ve kayıtlar yazıldıkları dilde kalır.

Bu bölüm ayrıca uygulama sürümünü (Agentbits v<sürüm>) ve veritabanı dosyasının yerini gösterir. Bir sorun bildirirken sürümü de yaz.

Verilerin nerede durur

Sistem	Veri klasörü
Windows	%APPDATA%\Agentbits
macOS	~/Library/Application Support/Agentbits
Linux	~/.config/Agentbits

Yedekler bu klasörün içindeki backups klasöründe durur. Ayrı bir veri klasörü kullanmak için (ör. deneme amaçlı) uygulamayı AGENTBITS_DATA_DIR ortam değişkeniyle başlat. Bkz. Kurulum.