Freebuff: Codebuff'ın Ücretsiz Kodlama Asistanı — Mac Mini Kurulum ve Kullanım Rehberi

Freebuff, Codebuff’ın ücretsiz sürümü — terminal üzerinde çalışan, sıfır konfigürasyonla başlayabileceğiniz bir AI kodlama asistanı. Abonelik gerektirmez, API key istemez, hemen çalışır.

Bu yazıda Freebuff’ı Mac Mini’ye nasıl kurduğumu, hangi özellikleri sunduğunu ve günlük iş akışımda nasıl kullandığımı anlatıyorum.

1. Freebuff Nedir?

Freebuff, Codebuff ekibi tarafından geliştirilen ücretsiz bir AI kodlama asistanıdır. Codebuff’ın tüm temel özelliklerini sunar — dosya okuma, kod düzenleme, terminal komutları çalıştırma, subagent yönetimi — ama herhangi bir ücret veya abonelik gerektirmez.

Not: Freebuff, Codebuff ile aynı kod tabanını kullanır (github.com/CodebuffAI/codebuff). Temel fark, Freebuff’ın ücretsiz bir modelle çalışması ve herhangi bir API key gerektirmemesidir.

Neden Freebuff?

1. Tamamen ücretsiz — Abonelik yok, kredi kartı gerekmez
2. Sıfır konfigürasyon — Kurulumdan saniyeler sonra kullanmaya başlayabilirsiniz
3. 9 özel subagent — Code review, browser test, deep thinking gibi görevler için uzman agent’lar
4. Terminal-native — IDE bağımlılığı yok, her ortamda çalışır
5. Açık kaynak — MIT lisansı ile kod tabanına erişebilirsiniz

2. Mac Mini Üzerinde Freebuff Kurulumu

Mac Mini’yi 7/24 çalışan bir AI geliştirme sunucusu olarak kullanıyorum. Freebuff’ı bu ortama kurmak, hem uzaktan erişimle hem de tmux oturumları üzerinden kesintisiz kodlama yapmamı sağlıyor.

Adım 1: Node.js Kurulumu

Freebuff, Node.js tabanlı bir CLI aracıdır. Mac Mini’de Node.js’in kurulu olduğundan emin olun:

# Node.js sürümünü kontrol et
node --version
# v20.x veya üzeri olmalı

# npm sürümünü kontrol et
npm --version

Eğer Node.js yoksa:

# Homebrew ile kurulum
brew install node

# veya nvm ile (versiyon yönetimi için)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts

Adım 2: Freebuff Kurulumu

Kurulum tek komut:

npm install -g freebuff

Bu kadar. Herhangi bir API key, hesap oluşturma veya konfigürasyon gerektirmez.

Adım 3: Kurulumu Doğrulama

freebuff --version
# veya
freebuff -v

Versiyon numarasını görmelisiniz. Eğer 0.0.x gibi bir sürüm görüyorsanız, başarıyla kurulmuş demektir.

Adım 4: İlk Çalıştırma

freebuff

Freebuff ilk çalıştığında, sizi karşılayan bir prompt göreceksiniz. Artık kodlama görevlerinizi doğrudan terminal üzerinden yapabilirsiniz.

3. Mac Mini’de Kalıcı Kullanım

Mac Mini’yi bir geliştirme sunucusu olarak kullanmak için Freebuff’ı her seferinde manuel başlatmak yerine, sürekli erişilebilir hale getirebilirsiniz.

Tmux ile Kalıcı Oturum

Tmux, terminal oturumlarının bağlantı kesilse bile canlı kalmasını sağlar:

# Tmux oturumu oluştur
tmux new-session -s freebuff

# Freebuff'ı başlat
freebuff

# Oturumu ayırmak için: Ctrl+B, D
# Tekrar bağlanmak için: tmux attach -t freebuff

Bu şekilde, SSH ile Mac Mini’ye bağlandığınızda kaldığınız yerden devam edebilirsiniz.

alias ile Hızlı Erişim

# ~/.zshrc veya ~/.bashrc'ye ekleyin
alias fb='freebuff'
alias fb-continue='freebuff --continue'

# Shell'i yenile
source ~/.zshrc

4. Freebuff’ın 9 Subagent’ı

Freebuff’ın en güçlü özelliklerinden biri, 9 özel subagent ile birlikte gelmesi. Her subagent belirli bir görevde uzmanlaşmıştır:

Bu subagent’lar, @AgentName formatı ile çağrılır:

# Code review subagent'ını çağır
# "@code-reviewer-deepseek-flash bu değişiklikleri review et"

# Browser test subagent'ını çağır
# "@browser-use localhost:3000'de formu test et"

5. Günlük Kullanım Senaryoları

Terminal’de Kod Yazma

Freebuff’ı başlattıktan sonra, herhangi bir kodlama görevini doğrudan terminalde anlatabilirsiniz:

$ freebuff
> src/utils/ klasörüne bir string helper fonksiyonu ekle
# Freebuff projeyi tarar, dosyaları okur ve kodu yazar

Proje Genelinde Değişiklik

> Tüm API route'larını kontrol et, eksik error handling varsa ekle

Freebuff projedeki tüm ilgili dosyaları bulur, okur ve gerekli değişiklikleri yapar.

Subagent Kullanımı

> @code-searcher "authenticateUser" fonksiyonunun tüm kullanımlarını bul
# Code searcher agent projeyi tarar ve sonuçları getirir

CI/CD Pipeline’ında

Freebuff headless modda da çalışabilir, bu sayede CI/CD entegrasyonu için idealdir:

# Tek seferlik komut
freebuff -p "Projedeki tüm TypeScript hatalarını bul ve raporla"

6. Freebuff vs. Diğer AI Kodlama Araçları

Ne Zaman Hangisi?

• Freebuff: Ücretsiz bir AI kodlama asistanı arıyorsanız, denemek istiyorsanız
• Codebuff: Daha güçlü modeller ve özelleştirme istiyorsanız, kendi API key’inizi kullanmak istiyorsanız
• Claude Code: Anthropic ekosisteminde çalışıyorsanız, MCP entegrasyonu gerekiyorsa
• Cursor: Görsel IDE deneyimi istiyorsanız, VS Code’dan aşina olduğunuz bir arayüz arıyorsanız

7. Mac Mini Üzerinde Performans

Freebuff’ı Mac Mini’de kullanmanın avantajları:

Apple Silicon Optimizasyonu

M serisi çipler, Node.js tabanlı CLI araçlarında oldukça verimli çalışır. Freebuff’ın subagent’ları arasında hızlı context geçişi sağlar.

7/24 Çalışma

Mac Mini’nin düşük enerji tüketimi sayesinde Freebuff her an kullanıma hazır:

# Mac Mini'ye SSH ile bağlan
ssh ebartan@mac-mini.local

# Mevcut tmux oturumuna bağlan
tmux attach -t freebuff

# Kaldığın yerden devam et

Arka Plan Çalıştırma

Freebuff’ı bir terminal oturumunda sürekli açık tutmak yerine, ihtiyaç duydukça çağırmak için:

# Direkt komutla çalıştır
freebuff -p "README.md dosyasını güncelle, yeni API endpoint'lerini ekle"

8. Freebuff’ın Geleceği

Freebuff, Codebuff ekibi tarafından aktif olarak geliştiriliyor. Kod tabanı github.com/CodebuffAI/codebuff adresinde mevcut ve topluluk katkılarına açık.

Özellikle dikkat çeken geliştirme alanları:

• Daha fazla subagent — Uzmanlaşmış agent’ların sayısı artıyor
• Daha hızlı modeller — Inference süresi sürekli iyileştiriliyor
• Daha iyi context yönetimi — Büyük projelerde daha verimli çalışma
• Topluluk eklentileri — Üçüncü parti subagent desteği

9. Sonuç

Freebuff, ücretsiz ve güçlü bir AI kodlama asistanı arıyorsanız mükemmel bir seçenek. Mac Mini üzerinde 7/24 çalışan bir geliştirme sunucusu olarak kullanmak, projelerinize her yerden erişmenizi sağlıyor.

Bu yazıda öğrendiklerimiz:

• ✅ Freebuff nedir ve Codebuff’tan farkı
• ✅ Mac Mini’ye kurulum adımları
• ✅ 9 özel subagent ve kullanım alanları
• ✅ Günlük workflow ve pratik senaryolar
• ✅ Diğer AI kodlama araçlarıyla karşılaştırma
• ✅ Mac Mini’de 7/24 çalıştırma konfigürasyonu

Freebuff’ı denemek isterseniz:

npm install -g freebuff

Ve terminalde freebuff yazmanız yeterli. Saniyeler içinde AI kodlama asistanınız hazır.

Hero görseli: fal.ai + FLUX.1 Dev ile üretilmiştir

Kaynaklar

• Freebuff Resmi Sitesi
• Codebuff Resmi Sitesi
• Codebuff GitHub
• Freebuff npm Paketi