ورود با شمارهٔ موبایل

دستور پایه

aira login

چی میفته:

1. CLI روی یه پورت آزاد محلی listener راه می‌اندازه (مثلاً http://localhost:54219/callback).
2. مرورگر پیش‌فرضت باز می‌شه روی صفحهٔ ورود آیراچت.
3. شماره‌ٔ موبایلت رو می‌زنی — یه کد ۶ رقمی پیامک می‌شه.
4. کد رو وارد می‌کنی و تایید می‌کنی.
5. مرورگر برمی‌گرده به localhost. CLI توکن رو می‌گیره و توی Keychain ذخیره می‌کنه.
6. صفحهٔ airachat.ir/airacode/welcome به نشانهٔ موفقیت باز می‌شه.

بررسی وضعیت

aira whoami        # کاربر فعلی
aira logout        # خروج، پاک کردن توکن‌ها

بدون مرورگر (CI، server، WSL)

روی محیط‌هایی که مرورگر در دسترس نیست، توکن رو از داشبورد آیراچت بگیر و به‌عنوان env var ست کن:

# توی airachat.ir → Settings → Developer → API Tokens
# یک token "AiraCode" بساز.

export AIRA_API_KEY=ey...
aira -p "تست"

رفرش

Access token عمر ۱۵ دقیقه‌ای داره. CLI خودش به‌طور خودکار refresh token رو استفاده می‌کنه. اگه refresh token هم منقضی شد (پس از ۳۰ روز عدم فعالیت)، باید دوباره aira login بزنی.

امنیت

• Token‌ها هیچ‌وقت توی config file خام (plain text) ذخیره نمی‌شن. macOS Keychain، Linux libsecret، Windows DPAPI.
• روی CI، AIRA_API_KEY رو به‌صورت secret تنظیم کن، نه plain env var.
• برای revoke از داشبورد آیراچت → Settings → Devices.