OpenAI, REST API'si için görsel, admin ve dosya destekli resmî CLI yayınladı

OpenAI resmî bir komut satırı istemcisi yayınladı

OpenAI, REST API'si için resmî bir CLI yayınladı; proje GitHub'da openai/openai-cli adıyla yayınlandı ve Hacker News'in ana sayfasına çıkmasıyla dikkat çekti. Araç, şirketin REST uçlarını kaynak odaklı bir komut yapısı üzerinden sunan bir Go programı ve hem Homebrew hem de Go'nun standart kurulum araçlarıyla dağıtılıyor.

Kurulum ve kimlik doğrulama

Projenin README'sine göre CLI, brew install openai/tools/openai ile kurulabiliyor ya da 1.26 veya üzeri sürüm gerektiren Go yoluyla: go install 'github.com/openai/openai-cli/cmd/openai@latest'. Go yolu binary'yi genellikle $HOME/go/bin olan Go bin dizinine yerleştiriyor ve README, bunun PATH'e eklenmesi gerekebileceğini belirtiyor.

Standart API uçları OPENAI_API_KEY ortam değişkeniyle kimlik doğrulaması yaparken, admin uçları ayrı bir OPENAI_ADMIN_KEY gerektiriyor. Tipik bir istek şöyle görünüyor: openai responses create --input "Say this is a test" --model gpt-5.5. Admin işlevleri de aynı biçimi izliyor; örneğin openai admin organization usage completions, kurum kullanım verisini almak için zaman aralığı ve bucket genişliği bayraklarıyla birlikte kullanılıyor. openai admin:organization:usage completions gibi eski iki nokta ayraçlı sözdizimi hâlâ çalışıyor ve openai help setup, kullanıcıları bir API anahtarını güvenli şekilde girmeleri konusunda yönlendiriyor. Yardım sayfaları ağ bağlantısı veya kimlik bilgisi olmadan görüntülenebiliyor.

Görseller, dosyalar ve betiklenebilir çıktı

CLI, salt istek taşımanın ötesine geçiyor. openai images generate --prompt "A tiny orange robot" ile görsel üretimi sonuçları ~/Downloads/gpt-images/ dizinine kaydediyor ve kaydedilen yolları yazdırıyor; açık bir model verilmediğinde README'nin gpt-image-2.5-sunburst olarak belirttiği öntanımlı bir model kullanılıyor. Ayrı images create-variation komutu emekliye ayrıldı; varyasyonlar artık images edit ile bir GPT Image modeli ve bir prompt üzerinden üretiliyor. Yerel dosyalar açık bir amaçla yüklenebiliyor, üst verileriyle incelenebiliyor ve diske geri indirilebiliyor.

Betikleme için başarılı yanıtlar varsayılan olarak, boruların içinde de dahil olmak üzere, okunabilir metin yazdırıyor; --format json, --format jsonl, raw ve yaml ise makine tarafından okunabilir çıktıya geçiyor. Hatalar stderr'e eyleme dönüştürülebilir özetler yazdırıyor; --format-error json özgün API hata yükünü ortaya çıkarırken --transform-error bir hata kodu gibi belirli alanları ayıklıyor.

Güncellemeler, yapılandırma ve tamamlama

Araç, yeni kararlı sürümleri herkese açık GitHub sürüm üst verisini okuyarak denetliyor: günde en fazla bir kez, kimlik bilgisi olmadan ve başarısız denetimler sessiz kalsın diye en fazla 200 milisaniye bekleyerek. Kendi kendine güncelleme yapmıyor; yalnızca en fazla yedi günde bir, doğrulanmış kurulumlar için uygun yükseltme komutuyla birlikte bir bildirim yazdırıyor. OPENAI_CLI_NO_UPDATE_CHECK=1 bu mekanizmayı tamamen devre dışı bırakıyor.

Yapılandırma API anahtarının ötesine uzanıyor; kurum ve proje kimlikleri, bir webhook sırrı, özel başlıklar ve karşılıklı TLS sertifika dosyaları için ortam değişkenleri ve eşleşen global bayraklar mevcut. Bir --base-url bayrağı, CLI'yı özel bir API arka ucuna yönlendiriyor; HTTPS, localhost ve loopback adresleri dışında zorunlu — bu, proxy'ler ve yerel ağ geçitleri için pratik bir kanca. Bash, zsh ve fish için kabuk tamamlaması sunuluyor; buna etkileşimli görsel seçici ve komut önerileri üzerinde Ctrl+X sonrası Tab araması da dahil, PowerShell ise normal Tab tamamlamasını koruyor.

Neden önemli

Çoğu geliştirici OpenAI ile dil SDK'ları, ham HTTP çağrıları ya da üçüncü taraf terminal sarmalayıcıları üzerinden etkileşim kuruyor. Resmî bir CLI, satıcıyı bizzat bu son kategoriye taşıyor, terminal öncelikli iş akışlarını meşrulaştırıyor ve şimdiye kadar bu boşluğu dolduran topluluk araçları için çıtayı yükseltiyor.

Tasarım tercihleri, rastgele denemeler yerine otomasyon odaklı bir yaklaşımı ima ediyor: çevrimdışı yardım, açık JSON modlarının yanı sıra boru dostu varsayılanlar, yapılandırılmış hata ayıklama, admin kullanım raporlaması, mTLS desteği ve özel bir base URL; betiklerin, CI hatlarının ve dahili araçların ihtiyaç duyduğu özellikler tam olarak bunlar. OpenAI API'sine karşı kendi komutlarını bir araya getiren ekipler için bu sürüm, bakımı yapılan birinci taraf bir alternatif sunuyor — ve Hacker News'in ana sayfasında hızla görünmesi, geliştiricilerin şimdiden dikkatini çektiğini gösteriyor.