Projeler

Proje, bilgisayarındaki bir klasör, o klasörde çalışan takımlar ve bir liderden oluşur. Bir projede yaptığın her şey o projede kalır: görevler, sohbet, çalışmalar, kararlar, raporlar, dosyalar ve proje hafızası. Ajanlar ve takımlar ise organizasyona aittir; istediğin kadar projede yeniden kullanılabilir.

Bir projede neler var

• Klasör: CLI ajanlarının dosya okuyup yazdığı, yeni kabukların açıldığı yer.
• Takımlar: projeye atanan birimler. Bir birimi seçmek alt birimlerini de kapsar; birimin ve alt birimlerinin tüm üyeleri projede çalışır.
• Lider: proje sohbetinde konuştuğun ajan.
• Ad, açıklama ve renk. Lider ve ajanlar açıklamayı bağlam olarak görür; projenin amacını ve kapsamını buraya yaz.

Geri kalan her şey projeye özeldir. Office yalnızca o projenin ekibini, Kanban panosu yalnızca onun görevlerini gösterir. Tüm projelerin ortak kullandığı tek şey organizasyon geneli hafızadır (bkz. Hafıza).

Ajanlar paylaşılır: aynı ajan birkaç projede üye olabilir ama aynı anda tek görevde çalışır. Başka bir projede meşgul olan üye Office’te soluk ve başka projede çalıştığını belirten bir etiketle görünür.

Proje sekmeleri ve bölümler

Açık projeler üst çubukta tarayıcı sekmeleri gibi durur: renk noktası, ad, koşan iş sayısı ve kapatma düğmesi. Yeni proje için +, Proje aç… ve Klasör aç… için proje değiştiriciyi kullan.

Projenin içindeyken üst çubuğun ikinci satırında proje bölümleri var; Ctrl+1 ile Ctrl+9 arasıyla da ulaşırsın:

Tuş	Bölüm	Ne işe yarar
1	Chat	#general’de liderle konuşma, ajanlara direkt mesaj, görev akışları. Bkz. Sohbet.
2	Office	Projenin ekibi pikselli ofiste. Bkz. Ofis.
3	Ekip	Projenin birimleri, üyeleri ve lideri.
4	Terminal	Ajan terminalleri ve kabuklar. Bkz. Terminaller.
5	Tasks	Kanban panosu. Bkz. Görevler.
6	Reports	İstatistikler, görev raporları, günlük rapor, token kullanımı. Bkz. Raporlar.
7	Decisions	Projenin karar kaydı. Bkz. Hafıza.
8	Browser	Senin için uygulama içi tarayıcı (ajanlar kullanamaz).
9	Dosyalar	Yüklenen dosyalar, ajan çıktıları ve klasörde değişen dosyalar. Bkz. Dosyalar.

Ctrl+Tab ve Ctrl+Shift+Tab proje sekmeleri arasında geçer. Son sekmeyi de kapatabilirsin; o zaman son projelerinin listelendiği Açık proje yok ekranı görünür.

Proje oluşturmak

1. Üst çubuktaki +’ya tıkla ya da Ctrl+P’ye basıp Yeni proje veya Klasör aç…’ı seç.
2. Bir Ad ve istersen bir Açıklama gir.
3. Bir Klasör seç. Klasör aç… ile başladıysan ve klasör zaten bir projeye aitse o proje açılır.
4. Takımlar altında projede çalışacak birimleri seç. Canlı önizleme kaç ajanın bu projede çalışacağını gösterir.
5. Proje lideri’ni Otomatik (takım lideri) bırak ya da belirli bir ajan seç.
6. Projeyi oluştur’a tıkla.

Takım seçmezsen sohbete yalnızca lider yanıt verir. Takımları sonra Ekip bölümündeki Takım ekle ile ya da Organizasyon sayfasında bir birimin Projeye ekle… düğmesiyle ekleyebilirsin.

Projeyi sonradan değiştirmek için sekmesine çift tıkla ya da durum çubuğunda proje adına tıklayıp Proje ayarları’nı aç.

Proje lideri

Lider #general’deki mesajlarına cevap verir, onları proje üyeleri için görevlere çevirir ve biten işi inceler. Agentbits lideri şu sırayla belirler:

1. Proje ayarlarında seçtiğin lider.
2. Atanmış birimler arasında lideri olan ilk birimin lideri.
3. Organizasyon lideri.
4. Projenin ilk üyesi.

Lider kendi projesinde atanmamış görev almaz; planlar ve inceler. Bkz. Görevler.

Proje klasörü kuralları

Klasör:

• var olmalı ve bir klasör olmalı;
• Agentbits uygulamasının kendi klasörü olmamalı;
• başka bir projede kullanılıyor olmamalı;
• fazla geniş olmamalı: sürücü kökü, kullanıcı klasörün ya da Agentbits verisini içeren bir klasör reddedilir.

Ajanların Claude Code CLI ya da Codex CLI kullanıyorsa klasör zorunludur. Klasör yoksa o projedeki CLI görevleri reddedilir ve bölümlerin yanında amber renkli Klasör seçilmedi çipi görünür. Demo ve API sağlayıcılarında klasör isteğe bağlıdır, çünkü bu ajanlar dosya düzenlemez.

Klasör diskte taşınır ya da silinirse proje “klasör bulunamadı” olarak işaretlenir; yeni yerini proje ayarlarından seçersin.

Uyarı: Ajanlar proje klasöründeki dosyaları gerçekten değiştirir ve birden çok ajan aynı klasörü aynı anda düzenleyebilir; çakışma yönetimi yoktur. Önemli işler için bir git dalı ya da kopya kullan.

Açılışta projeleri açmak

Agentbits açılırken Hangi projeleri açalım? diye sorar. Projeler son açılma zamanına göre sıralanır; altıdan fazla proje varsa arama, ayrıca Arşivdekiler grubu çıkar. Son oturumdaki sekmeler önceden işaretlidir. Tıklayınca seçilir, çift tıklayınca hemen açılır, Enter seçilenleri açar.

Bu adımı atlamak için Açılışta sorma, son açık projeleri aç’ı işaretle; sonradan Ayarlar → Genel → Açılışta’dan değiştirebilirsin.

Arşivlemek ve silmek

Arşivle projenin sekmesini kapatır ve projede yeni iş başlamasını engeller; otopilot arşivdeki projelere bakmaz. Projeyi proje seçiciden yeniden açtığında arşivden çıkar.

Projeyi sil projenin görevlerini, çalışmalarını, sohbetlerini, kararlarını, raporlarını, dosya kayıtlarını ve proje hafızasını kalıcı olarak siler. Ajanlar ve takımlar kalır. Proje klasörü ve içindeki dosyalar asla silinmez.

Her zaman en az bir proje vardır; bu yüzden kalan tek proje silinemez. Varsayılan projeyi silersen bu rol en son açtığın diğer projeye geçer.

Projeyi tutup geçmişinin bir kısmını temizlemek için proje ayarlarında Hafızayı ve geçmişi temizle → Verileri yönet’i kullan. Bkz. Ayarlar.

Not: Sekmeyi kapatmak projeyi yalnızca gizler. Hiç sekme açık olmasa da ajanlar tüm aktif projelerde çalışmaya devam eder. İşi durdurmak için üst çubuktaki Tümünü duraklat’ı kullan ya da projeyi arşivle.