Dokümanlar/CLI Referansı

CLI Referansı

Yerel kurulum ve inceleme komutları için referans. CLI operatörün makinesinde çalışacak, bundle’ları idempotent uygulayacak ve bir adaptörün gerçekten uygulamadığı desteği varmış gibi göstermeyecek şekilde tasarlanmıştır.

Temel Mimari

vibebasket CLI, idempotent bir yerel installer olarak çalışır. Bir bundle URL’i veya yerel manifest dosyası verildiğinde manifest’i alır, yalnızca hedef adaptörün gerçekten desteklediği yetenekleri uygular, güvenli şekilde temsil edemediği hedef veya MCP girdilerini atlar, gerçek bir config değişikliği gerektiğinde bilinen config dosyalarını değiştirmeden önce yedek alır ve o hedefte readback uygulanmışsa yazılan sonucu doğrular.

Mevcut Komutlar

vibebasket apply <url|file>

Ana komuttur. Host edilen bir bundle URL’i veya yerel bir JSON manifest dosyasını kabul eder, manifest’i doğrular ve her öğeyi (MCP server’ları, skill’ler, rule’lar) uyumlu tüm yerel adaptörlere uygular. Adaptörler mevcut config dosyalarını yalnızca gerçekten bir MCP config mutasyonu gerekiyorsa yedekler ve girdileri idempotent şekilde merge eder; bu yüzden apply komutunu iki kez çalıştırmak güvenlidir. Bir hedef bundle’ın bir kısmını temiz biçimde destekleyemiyorsa CLI başarılı oldu numarası yapmak yerine o hedefi skipped olarak raporlar.

Mevcut kapsam

Ana kurulum yolu apply komutudur. list, search, doctor, init ve rollback gibi yardımcı komutlar bugün kullanılabilir durumdadır.

apply — Bayraklar

BayrakTipAçıklama
--force / -fBooleanEtkileşimli güven onayını atlar ve aynı id zaten varsa adaptör MCP merge işlemlerinin mevcut girdinin üzerine yazmasına izin verir.
--scope / -suser | projectBundle kapsamını override eder. user home dizinine, project ise çalışma dizinine göre kurulum yapar.
--dry-run / -dBooleanDiske yazmadan bekleyen config değişikliklerini önizler. Uygulanacak hedef yapılandırmayı gösterir.
--no-verifyBooleanKurulum sonrası readback kontrollerini atlar. Sadece debug veya readback’in geçici olarak güvenilmez olduğu sıra dışı yerel ortamlarda faydalıdır.

Diğer Komutlar

vibebasket list

Tüm 24 IDE hedefini tarar ve hedef bazında kurulu MCP server’larını, skill’leri ve rule’ları raporlar.

vibebasket search <query>

Terminalden FTS5 full-text index ile VibeBasket kataloğunu arar. Host edilen katalogdaki MCP, Skill ve Rule kayıtları arasından en fazla 10 eşleşme döndürür. Mevcut terminal yüzeyi kasıtlı olarak hafiftir ve tam görsel gezinmeden çok hızlı katalog keşfi için uygundur.

vibebasket init

Proje kapsamlı secret’lar ve varlıklar için yerel bir .vibebasket.env şablonuyla birlikte .vibebasket/ çalışma alanı yapısını oluşturur.

vibebasket doctor

Yerel ortamı teşhis eder: .vibebasket proje yapısını kontrol eder, adaptör config varlığını inceler, okunabildiğinde MCP sayılarını raporlar ve mevcut makine için kısa bir ortam özeti yazdırır.

vibebasket rollback

Etkileşimli bir geri yükleme akışı açar, son zaman damgalı yedeklerden seçim yapmanı sağlar ve ardından seçilen adaptör config anlık görüntüsünü geri yükler. Proje kapsamlı yedeklerde, geri yüklemek istediğin aynı proje kökünden çalıştır.

vibebasket mcp serve

Yerel stdio VibeBasket MCP sunucusunu çalıştırır. Bu yüzey IDE tarafında katalog arama, hedef rehberliği, kurulum planlama, bundle apply, yedek inceleme, rollback ve yerel stack kaydetme/yükleme için kullanılır. Cloud stack save ise bugün kasıtlı olarak hâlâ web sitesi üzerinden yürür.