Co-Wrangler: Terminalinizdeki Otonom AI Mühendisi ve SOP Yöneticisi

Yazılım geliştirme süreçlerinde yapay zekayı bir sohbet arayüzünden çıkarıp doğrudan terminalimize, yani kodun yazıldığı kalbe indirmek verimliliği bambaşka bir seviyeye taşıyor. Co-Wrangler, standart web tabanlı sohbet arayüzlerinin aksine tamamen terminalinizde yaşayan, dosya sisteminize hakim ve belirli iş akışlarını (SOP) katı bir disiplinle takip eden otonom bir AI mühendisidir.

Co-Wrangler Nedir?

Co-Wrangler, karmaşık kod tabanlarını düzenlemek, yerel dosyaları yönetmek ve Standart Operasyon Prosedürlerini (SOP) yürütmek için tasarlanmış, terminal-native bir yapay zeka mühendislik ajanıdır. Mevcut çalışma dizininizin bağlamını anlar, projeye özel mimari kuralları dinamik olarak yükler ve API anahtarlarınızı merkezi bir kasada güvenli bir şekilde yönetir.

Sıradan sohbet botlarının aksine Co-Wrangler, sadece bir danışman değil, dosya sisteminde işlem yapabilen ve projenin geçmişini memory.md üzerinden takip edebilen profesyonel bir iş ortağıdır.

Temel Özellikler

• Çift Beyinli Mimari: Sistem, küresel kapsamda (~/.cowrangler) merkezi API anahtarlarını ve genel SOP’ları yönetirken, yerel kapsamda (./.cowrangler) projeye özel hafıza ve görev takibi sunar.
• Güvenli Kasa (Secure Vault): API anahtarlarınız merkezi bir kasada güvenle saklanır, böylece her projeye .env dosyası kopyalama zorunluluğu ve anahtarların yanlışlıkla commit edilme riski ortadan kalkar.
• Dinamik Model Kaydı: Gemini, Claude veya GPT (OpenRouter aracılığıyla) gibi modeller arasında kod değiştirmeden, sadece CLI üzerinden anlık geçiş yapabilirsiniz.
• Uygulanabilir SOP’lar (Skills): Markdown tabanlı yetenek dosyaları yazabilir ve ajanın bu mimari standartlara her komutta uymasını sağlayabilirsiniz.
• Gelişmiş CLI Deneyimi: Yazım sırasında herhangi bir noktada / ile tetiklenen akıllı komut önerileri (IntelliSense) ve Tab tuşu ile tamamlama özellikleri sunar.

---

Kurulum ve Hızlı Başlangıç

Co-Wrangler’ı makinenizde kullanmaya başlamak için aşağıdaki adımları takip edebilirsiniz:

1. Global Kurulum

Depoyu klonlayın ve otomatik kurulum betiğini çalıştırın:

git clone https://github.com/furkangonel/cowrangler.git
cd cowrangler
npm run setup

Bu komut bağımlılıkları yükler, TypeScript kodunu derler ve cowrangler yürütülebilir dosyasını sisteminize global olarak bağlar.

2. API Anahtarınızı Ayarlayın

Kullanmak istediğiniz sağlayıcının API anahtarını küresel kasanıza bir kez kaydedin:

cowrangler

# CLI içindeyken:
❯ /key set OPENROUTER_API_KEY sk-or-v1-key-buraya

3. Ajanı Başlatın

Herhangi bir proje dizinine gidin ve ajanı uyandırın:

cd ~/projelerim/yeni-proje
cowrangler

---

Sistem Direktifleri (Komutlar)

Co-Wrangler, AI ortamınızı yönetmek için kapsamlı bir slash-komut seti sunar:

Komut	Açıklama
/help	Kullanım kılavuzunu ve mevcut tüm komutları listeler.
/model set <ad> [global/local]	Aktif modeli değiştirir. local seçeneği sadece mevcut projeyi etkiler.
/key set <PROVIDER> <KEY>	API anahtarını kasaya güvenle kaydeder.
/tools	Mevcut sistem araçlarını (dosya okuma, yazma vb.) listeler.
/skills	Yüklü olan tüm Standart Operasyon Prosedürlerini (SOP) listeler.
/skill <id> <görev>	Ajanı belirli bir SOP’yi kullanarak görevi yapmaya zorlar.
/reset	Proje hafızasını koruyarak konuşma geçmişini temizler.
/exit	Oturumu güvenli bir şekilde sonlandırır.

---

Dosya Sistemi ve Mimari

Co-Wrangler, AI bağlamını yönetmek için otomatik olarak iki gizli dizin oluşturur:

Global Kapsam (~/.cowrangler/)

Tüm makine genelinde geçerli olan ayarları içerir. API anahtarları (credentials.env), global modeller (config.yaml) ve her yerde kullanılabilen genel SOP’lar burada saklanır.

Yerel Kapsam (./.cowrangler/)

Komutu çalıştırdığınız proje dizinine özeldir ve şu kritik dosyaları içerir:

• memory.md: Projenizin teknoloji yığını ve mimari kuralları burada tutulur; ajan her açılışta bu bağlamı okur.
• AGENT_TODO.md: Ajanın oturumlar arasındaki durumunu ve bekleyen görevlerini takip ettiği dosyadır.

---

Özel Yetenekler (SOP) Yazmak

skills/ dizinine Markdown dosyaları ekleyerek ajanı belirli kurallara uymaya zorlayabilirsiniz. Örneğin, temiz kod standartları için bir dosya oluşturup şu şekilde tetikleyebilirsiniz:

❯ /skill clean_code Kullanıcı doğrulama modülünü refactor et.

Kaynaklar

• GitHub: Co-Wrangler Repository
• Vercel AI SDK Documentation

İletişim

Sorularınız ve geri bildirimleriniz için furkan@furkangonel.me yoluyla iletişime geçebilirsiniz.