‏OpenAI CLI رسمی منتشر شد

OpenAI یه CLI رسمی برای REST API خودش منتشر کرده که با Go نوشته شده. نصبش از Homebrew یا با go install انجام می‌شه و برای نسخه Go حداقل 1.26 لازمه. ساختار دستورها بر اساس منبع هست: اول اسم منبع، بعد زیرمنبع، بعد دستور و فلگ‌ها. مثلاً برای ساختن یه پاسخ ساده این‌طوری می‌نویسی:

openai responses create \
  --input "Say this is a test" \
  --model gpt-5.5

برای endpointهای معمولی کلید OPENAI_API_KEY کافیه، ولی دستورهای ادمین مثل گزارش مصرف سازمان کلید جداگانه OPENAI_ADMIN_KEY می‌خوان. راهنما بدون کلید API و حتی بدون اینترنت کار می‌کنه و با --help روی هر دستوری صفحه کاملش رو می‌بینی. خروجی موفق به طور پیش‌فرض متن خوانا هست، حتی تو pipe. برای اسکریپت‌ها باید --format json یا jsonl بدی و با --transform می‌تونی با سینتکس GJSON فقط بخشی از داده رو بیرون بکشی.

بخش تصویر هم امکانات خودش رو داره. دستور openai images generate تصویرها رو تو پوشه ~/Downloads/gpt-images/ ذخیره می‌کنه و اگه مدل رو مشخص نکنی از gpt-image-2.5-sunburst استفاده می‌کنه. فایل‌های قبلی هیچ‌وقت بازنویسی نمی‌شن. دستور images create-variation حذف شده و جاش باید از images edit با یه پرامپت استفاده کنی. با images preview هم می‌شه یه تصویر ذخیره‌شده رو بدون درخواست به API دوباره نشون داد.

برای فرستادن فایل داخل ورودی JSON، علامت @ اول اسم فایل محتواش رو می‌خونه. این راحته ولی اگه ورودی از یه منبع ناشناس pipe بشه خطرناکه، چون ممکنه فایل‌های محلی رو بخونه. برای همین متغیر OPENAI_UNTRUSTED_STDIN=1 هست (یعنی حالتی که ورودی stdin فقط داده خام حساب می‌شه) و توش ارجاع‌های @ دیگه فایلی نمی‌خونن. هدرهای سفارشی هم تو لاگ‌های debug مخفی می‌شن و برای هدرهای حاوی رمز پیشنهاد شده از OPENAI_CUSTOM_HEADERS استفاده بشه تا رمز تو history شل نمونه.

ابزار از mutual TLS هم پشتیبانی می‌کنه، یعنی کلاینت هم با گواهی خودش احراز هویت می‌شه. این قابلیت هنوز بتاست، فایل گواهی و کلید خصوصی باید جدا و با هم تنظیم بشن، و آدرس endpoint مخصوص mTLS رو باید خودت با OPENAI_BASE_URL بدی. پروکسی‌های HTTPS تو این حالت رد می‌شن تا گواهی کلاینت به پروکسی نشون داده نشه. CLI هر هفت روز یه بار نسخه جدید رو چک می‌کنه ولی هیچ‌وقت خودکار آپدیت نمی‌کنه، و با OPENAI_CLI_NO_UPDATE_CHECK=1 خاموش می‌شه. pull request فقط از همکاران ریپو قبول می‌شه و مجوزش Apache 2.0 هست.

نکات کلیدی:

• نصب با Homebrew یا go install؛ نیاز به Go نسخه 1.26 یا بالاتر
• کلید OPENAI_ADMIN_KEY برای دستورهای ادمین جدا از OPENAI_API_KEY لازمه
• مدل پیش‌فرض تصویر: gpt-image-2.5-sunburst، ذخیره در ~/Downloads/gpt-images/
• دستور images create-variation حذف شده و جاش images edit هست
• OPENAI_UNTRUSTED_STDIN=1 جلوی خوندن فایل محلی از ورودی ناشناس رو می‌گیره
• پشتیبانی بتا از mutual TLS؛ پروکسی HTTPS در این حالت پشتیبانی نمی‌شه
• مجوز Apache 2.0؛ pull request فقط از همکاران ریپو