CLI Referansı

opencodex CLI’sı ocx’tir. setup/init, restore/eject ve models/model gibi belgelenmiş takma adların aynı işleme ulaşmasıyla ilk komut adında dağıtım yapar. Bilinmeyen komutlar ve geçersiz komut şekilleri hatadır.

Üst düzey kullanım için ocx help (veya ocx --help / ocx -h) çalıştırın. Yardım tablosunda kayıtlı bir komut için ocx help <komut>, ocx <komut> --help veya ocx <komut> -h çalıştırın. Yardım ve sürüm komutları salt okunurdur: Codex veya opencodex durumunu başlatmaz, durdurmaz, kurmaz, kaldırmaz veya yeniden yazmazlar.

Komut aileleri

• Yaşam Döngüsü — kurulum, proxy ve servis yaşam döngüsü, sağlık, tanılama, katalog senkronizasyonu, kontrol paneli ve güncellemeler.
• Sağlayıcılar, hesaplar ve modeller — sağlayıcı yapılandırması, kimlik doğrulama, kimlik bilgisi havuzları, kota, özel modeller, görünürlük, seçilen modeller ve bağlam sınırları.
• Ajanlar, yönlendirme ve entegrasyonlar — çoklu ajan kontrolleri, kombolar, gözlemlenebilirlik, kabul anahtarları, istemci entegrasyonları, çalışma zamanı ayarları ve doğrulanmış yapılandırma.

Başsız (Headless) davranış

Yönetim komutları, ikinci bir yapılandırma yolunu sürdürmek yerine kaydedilen çalışma zamanı portunu ve kimlik denetimlerini kullanarak canlı proxy’nin yönetim API’sine gidiş-dönüş yapar. Durdurulmuş veya erişilemeyen bir proxy HTTP 503 olarak temsil edilir ve sıfır olmayan bir CLI çıkışı üretir. Çevrimdışı yapılandırma işlemleri olarak açıkça belgelenen komutlar, bunun yerine canlı bir proxy olmadan yapılandırma dosyasını doğrulayabilir ve düzenleyebilir.

Belirsiz olmayan yerlerde liste veya durum varsayılandır. Yapılandırılmış anlık görüntüler için --json ve akışlı bir istek günlüğü akışı için ocx observe logs --follow --jsonl kullanın. Tema, dil, gezinme ve diğer tamamen görsel tarayıcı durumlarının CLI eşdeğeri yoktur; Cloudflare Tünel kurulumu bu komut kümesinin dışındadır.

Çıkış kodları ve onaylama

Başarılı komutlar 0 ile çıkar. Geçersiz kullanım, bilinmeyen komutlar veya kaynaklar, başarısız API işlemleri ve kullanılamayan gerekli servisler sıfır olmayan bir çıkış yapar. ocx health özellikle yalnızca proxy sağlıklı olduğunda 0 ve aksi takdirde 1 ile çıkar, bu nedenle bir servis probu olarak kullanılabilir. Betikler insan tarafından okunabilir çıktıyı kazımak yerine çıkış kodunu test etmelidir.

Onay bildiren yıkıcı kaldırma, içe aktarma, kredi tüketimi ve güncelleme işlemleri etkileşimsiz kullanımda --yes gerektirir. Bayrak açık bir katılımdır; atlanması eylemi sessizce onaylamamalıdır.

Sürüm ve dahili dağıtım hedefleri

ocx --version, ocx -v ve ocx version betik dostu tek bir sürüm satırı yazdırır ve çıkar.

İki dağıtım hedefi normal yardımdan kasıtlı olarak çıkarılmıştır: __refresh-version [preview], ayrılmış bir süreçte güncelleme bildirimi önbelleğini yeniler ve __gui-update-worker <is-kimligi> [latest|preview] [restart], bir kontrol paneli güncelleme işini çalıştırır. Bunlar kararlı kullanıcıya yönelik komutlar değil, uygulama ayrıntılarıdır. Kontrol paneli çalışan PID’sini kaydeder, çalışanı ölen aktif bir işi kurtarır, daha eski PID’siz aktif kayıtları on dakika sonra eski olarak değerlendirir ve canlı bir çalışanı eşzamanlı güncellemelerden korur.