Kurulum

Agentbits 0.1.0’ın Windows kurulum dosyası ve deneysel macOS paketleri var; istersen kaynaktan da çalıştırabilirsin. Bu sayfada neye ihtiyacın olduğunu, uygulamayı nasıl kurup başlatacağını, verilerin nerede durduğunu ve güncelleyip kaldırınca ne olduğunu bulursun.

Sistem gereksinimleri

Windows 10/11	Ana hedef. Kurulum dosyası x64 içindir.
macOS	Deneysel. Apple Silicon ve Intel için DMG paketleri yayımlandı ama henüz gerçek bir Mac’te denenmedi.
Linux	Paket yok. Kaynaktan çalıştırma çalışır.
Node.js 22 ya da üstü	Yalnızca Agentbits’i kaynaktan çalıştırmak ya da derlemek için gerekir. Kurulum dosyası istemez.
Bir yapay zeka sağlayıcısı	Başta isteğe bağlı. Ücretsiz Demo hiçbir şey istemez. Gerçek iş için Claude Code CLI, Codex CLI ya da bir Anthropic veya OpenAI API anahtarı gerekir. Bkz. Sağlayıcılar.

Agentbits API anahtarlarını ve parolaları işletim sisteminin anahtar zinciriyle saklar: Windows DPAPI, macOS Keychain ya da Linux Secret Service. Anahtar zinciri yoksa Agentbits sır kaydetmeyi reddeder.

Kurulum dosyasını indir

Dosyayı İndir sayfasından ya da GitHub’daki v0.1.0 sürümünden al:

Platform	Dosya
Windows 10/11 (x64)	Agentbits-Setup-0.1.0.exe
macOS, Apple Silicon	Agentbits-0.1.0-arm64.dmg
macOS, Intel	Agentbits-0.1.0-x64.dmg

Kurulum dosyaları henüz kod imzalı değil. İlk çalıştırmada Windows SmartScreen uyarı verir:

1. “Windows bilgisayarınızı korudu” penceresinde Ek bilgi’ye tıkla.
2. Yine de çalıştır’a tıkla.

macOS da uygulamayı ilk açılışta engelleyebilir: Sistem Ayarları → Gizlilik ve Güvenlik’i açıp Yine de Aç’ı seç.

Kurulum sihirbazı kimin için ve nereye kurulacağını seçtirir, masaüstüne ve Başlat menüsüne kısayol ekler, lisansı gösterir. Claude Code CLI ve Codex CLI pakete dahil değil; kullanmak istersen ayrıca kurup oturum aç (claude auth login, codex login).

İndirdiğin dosyayı doğrula

SHA-256 özetleri sürümdeki SHA256SUMS-windows.txt ve SHA256SUMS-macos.txt dosyalarında. Özet yalnızca dosyanın bozulmadığını gösterir; imza değildir.

Get-FileHash Agentbits-Setup-0.1.0.exe -Algorithm SHA256

Beklenen: d56f80c11ea45903335644cde2742cce366ab26b9339127ad089adeee761e100

Kaynaktan çalıştırma

Linux’ta ya da kodu takip etmek istersen bu yolu kullan.

1. Node.js 22 ya da üstünü kur. node --version ile kontrol et.

2. Kodu indir ve bağımlılıkları kur:

   git clone https://github.com/godilman/agentbits.git
   cd agentbits
   npm ci

   npm ci Electron’u ve diğer paketleri indirir. Yerel modüller hazır derlenmiş gelir; Visual Studio Build Tools ya da başka bir derleyici gerekmez.

3. Uygulamayı başlat:

   npm run dev

npm run dev geliştirme modunu başlatır, kod değişince yenilenir. Bunun yerine üretim derlemesini çalıştırmak için:

npm run build
npm start

Windows kurulum dosyasını kendin derle

Windows’ta kurulum dosyasını kendi bilgisayarında derleyebilirsin:

npm ci
npm run dist:win

Sonuç release/Agentbits-Setup-<sürüm>.exe (x64) dosyasıdır. Paketin temiz bir kurulumdan derlenmesi için önce npm ci çalıştır. Kurulum sihirbazı kimin için ve nereye kurulacağını seçtirir, masaüstüne ve Başlat menüsüne kısayol ekler, lisansı gösterir. Yayımlanan kurulum dosyası gibi bu da imzasızdır; yukarıdaki SmartScreen uyarısını bekle.

Bir şeyler ters giderse

• PowerShell “running scripts is disabled on this system” diyorsa: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned çalıştır ya da onun yerine npm.cmd run dev kullan.
• “Electron failed to install correctly” hatası: Electron indirmesi yarıda kalmış. node node_modules\electron\install.js çalıştır.

Diğer çözümler Sorun giderme sayfasında.

Veriler nerede durur?

Agentbits’in sakladığı her şey (organizasyon, projeler, sohbetler, görevler, hafıza, raporlar, eklenen dosyalar, yedekler) bilgisayarındaki tek bir veri klasöründedir:

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

Veritabanı agentbits.db dosyasıdır; yanında agentbits.db-wal ve agentbits.db-shm bulunur. Yedekler backups klasörüne, eklenen dosyaların orijinalleri files klasörüne yazılır. Klasörü uygulamadan açmak için Ayarlar → Veri yönetimi’ne git ve Klasörü aç’a tıkla.

Proje klasörlerin bundan ayrıdır. Agentbits onları asla silmez, yedekler de onları kapsamaz.

Ayrı bir test profili kullan

AGENTBITS_DATA_DIR ortam değişkeniyle Agentbits’e başka bir klasör gösterebilirsin. Normal verilerine dokunulmaz, boş bir klasör de sana temiz bir ilk açılış verir.

$env:AGENTBITS_DATA_DIR = "$env:TEMP\agentbits-test"; npm run dev     # Windows PowerShell

AGENTBITS_DATA_DIR=/tmp/agentbits-test npm run dev                     # macOS / Linux

Klasör yoksa oluşturulur. Her veri klasörü ayrı bir uygulama örneği olarak çalışır. Aynı veri klasörüyle Agentbits’i ikinci kez açmak yalnızca mevcut pencereyi öne getirir. Test profilini sıfırlamak için uygulamayı kapat ve o klasörü sil.

İpucu: Şablonları, onayları, temizliği, yedeklemeyi ve sıfırlamayı gerçek verilerini riske atmadan denemek için test profilini Demo sağlayıcıyla kullan.

Güncelleme

Agentbits kendini güncellemez.

• Kurulum dosyasıyla: yeni kurulum dosyasını eski sürümün üzerine çalıştır. Önce kaldırman gerekmez. İlk seferdeki kurulum seçeneğinin aynısını (yalnızca senin için ya da herkes için) seç. Veri klasörün korunur; yeni sürüm açılışta veritabanını yükseltir.

• Kaynaktan: yeni kodu çek, bağımlılıkları yeniden kur ve tekrar başlat:

  git pull
  npm ci
  npm run dev

Uyarı: Yükseltilmiş bir veritabanını Agentbits’in eski bir sürümüyle açmak desteklenmez. Güncellemeden önce Ayarlar → Veri yönetimi’nden yedek al.

Kaldırma

Agentbits’i kaldırmak uygulamayı siler ama veri klasörünü korur; daha sonra yeniden kurarsan kaldığın yerden devam edersin. Verilerini de silmek istiyorsan kaldırdıktan sonra yukarıdaki veri klasörünü elle sil. Bu, organizasyonunu, projelerini, geçmişini ve kayıtlı API anahtarlarını siler. Diskteki proje klasörlerine dokunulmaz.