Terminalinizde Xoral

Ajan doğrudan proje klasörünüzde çalışır: dosyaları okur, kodu düzenler, komutları ve testleri çalıştırır, web'de arama yapar. Değişiklik yapmadan önce izin ister.

Kurulum

macOS ve Linux

curl -fsSL https://xoral.si/install | sh

Windows (PowerShell)

irm https://xoral.si/install.ps1 | iex

Kullanıcı klasörünüzdeki .xoral/bin dizinine kurulur ve kendini PATH'e ekler. Yönetici yetkisi gerekmez.

İlk çalıştırma

Proje klasörünüzde bir terminal açın ve xoral komutunu çalıştırın.
/connect yazın, Xoral'ı seçin ve erişim anahtarınızı yapıştırın.
Görevi kendi cümlelerinizle anlatın, örneğin: “cart.test.ts içindeki test neden başarısız oluyor, bul ve düzelt”.

Anahtarı XORAL_API_KEY ortam değişkeniyle de tanımlayabilirsiniz. Xoral CLI kapalı beta aşamasındayken anahtarlar talep üzerine verilir: support@xoral.si adresine yazın.

Modeller

Model	Ne için
Xoral Forge	Ana model, varsayılan olarak seçilidir: kod yazar ve düzeltir, hataları inceler.
Xoral Spark	Hızlı yanıtlar ve küçük düzenlemeler.
Xoral Titan	Zor görevler: mimari, büyük değişiklikler, kod incelemeleri. Limiti 12 kat daha hızlı tüketir.

Modeli /models komutuyla değiştirin.

Faydalı komutlar

`xoral`	Ajanı geçerli klasörde aç
`xoral run "…"`	Arayüz olmadan tek bir görev çalıştır
`xoral upgrade`	Xoral'ı en son sürüme güncelle
`xoral --help`	Tüm komutlar

Ajan için projeye özel kuralları proje kök dizinindeki AGENTS.md dosyasına yazın.

Xoral CLI, OpenCode tabanlıdır ve MIT lisansı ile dağıtılır.