فرمانها
مرجع پرچمهای CLI آیرا کد، subcommandها، و slash commandهای درون نشست.
پرچمهای CLI
-p, --print <prompt> | حالت headless. چاپ روی stdout و خروج بعد از یک turn. |
--model <id> | alias مدل یا ID مدل provider. |
--output-format <fmt> | text، json، یا stream-json. |
--effort <low|medium|high|max> | میزان effort استدلال برای مدلهایی که پشتیبانی میکنن. |
--thinking <mode> | گزینهٔ سازگاری: low/medium/high/max به effort نگاشت میشن؛ enabled/adaptive/disabled حالت thinking رو کنترل میکنن. |
--permission-mode <mode> | default، plan، bypassPermissions، acceptEdits، یا dontAsk. |
--dangerously-skip-permissions | رد کردن تمام promptهای permission. فقط توی اجراهای ایزولهٔ CI یا sandbox استفاده کن. |
--chrome / --no-chrome | روشن یا خاموش کردن یکپارچگی بتای مرورگر آیرا برای این نشست. |
--bare | حالت hermetic: بدون خوندن keychain یا config، مگه اینکه صریح داده بشه. |
-d, --debug [filter] | روشن کردن حالت debug با فیلتر اختیاری مثل api,hooks. |
--mcp-config <path> | استفاده از یک فایل پیکربندی MCP اختصاصی برای این نشست. |
--add-dir <path> | افزودن یک دایرکتوری دیگه به scope مجاز workspace. |
-v, --version | چاپ نسخه. |
-h, --help | نمایش راهنما. |
Subcommandها
aira help [command] | نمایش راهنمای AiraCode یا یک subcommand مشخص. |
aira login | شروع فلوی ورود OAuth. |
aira whoami | نمایش حساب فعلی و وضعیت احراز هویت. |
aira logout | حذف توکن احراز هویت ذخیرهشده. |
aira version | چاپ نسخهٔ AiraCode. |
aira doctor | اجرای عیبیابی نصب و بهروزرسان. |
aira auth status | نمایش وضعیت ورود، OAuth، و auth-cache. |
aira balance | نمایش موجودی آیراکردیت تو. |
aira credits [days] | نمایش تفکیک اعتبار و مصرف. |
aira usage [days] | نمایش مصرف حساب و پروژه. |
aira topup | باز کردن صفحهٔ شارژ آیراکردیت. |
aira extra-usage | باز کردن یا چاپ مسیر مدیریت مصرف اضافه. |
aira setup-token | ساخت یا رفرش یک توکن برای محیطهای headless. |
aira passes | مرور passهای حساب آیرا. |
aira import-settings [source] [options] | وارد کردن تنظیمات سازگار از دستیارهای کدنویسی دیگه. |
aira import-config [source] [options] | alias برای aira import-settings. |
aira model [model] | نمایش یا تنظیم مدل AiraCode. |
aira mod [model] | alias برای aira model. |
aira stats [7d|30d|all] | نمایش آمار مصرف و فعالیت AiraCode. |
aira keybindings | باز کردن یا ساخت ~/.aira/keybindings.json. |
aira release-notes | نمایش release noteهای AiraCode. |
aira stickers | باز کردن استیکرها، نشانها، و منابع برند AiraCode. |
aira install-slack-app | اتصال Slack بهعنوان کانکتور MCP آیرا کد. |
aira context | نمایش مصرف فعلی context window. |
aira cost | نمایش خلاصهٔ هزینهٔ نشست فعلی. |
aira copy | توضیح اینکه چطور خروجی حالت print رو کپی کنی. |
aira goal <objective> | تنظیم یک هدف پایدار پروژه. |
aira workflow <objective> | پیشنمایش یک workflow با مسیریابی مدل، برنامهریزی بودجه، و مراحل تأیید. |
aira deep-research <question> | پیشنمایش تحقیق عمیقِ مسیریابیشده به aira-deep با الزام ارجاعدهی. |
aira research <question> | alias برای aira deep-research. |
aira genimage --dry-run <prompt> | برنامهریزی تولید تصویر با متادیتای مسیر و مصرف. برای تم ایرانی از --persian ui|brand|editorial|icon، --no-text، یا --exact-text استفاده کن. |
aira image --dry-run <prompt> | alias برای aira genimage. |
aira gen-image --dry-run <prompt> | alias برای aira genimage. |
aira images --dry-run <prompt> | alias برای aira genimage. |
aira generate-image --dry-run <prompt> | alias برای aira genimage. |
aira remote-control | بررسی handoff و مسیریابی برای app.airacode.ir/code. alias: aira rc. |
aira remote-env | نمایش راهنمای راهاندازی محیط راهدور. |
aira batch <instruction> | باز کردن workflow تعاملی batch-agent. |
aira debug [issue description] | باز کردن دستیار تعاملی debug. |
aira init | ساخت دستورالعملهای پروژه توی یک نشست تعاملی. |
aira insights | ساخت گزارش تعاملی insight از نشستهای AiraCode. |
aira pr-comments | بررسی کامنتهای pull request توی یک نشست تعاملی. |
aira review | ریویو یک pull request توی یک نشست تعاملی. |
aira security-review | اجرای ریویو امنیتی تعاملی روی تغییرات در انتظار. |
aira simplify | ریویو کد تغییریافته از نظر استفادهٔ مجدد، کیفیت، و کارایی. |
aira update-config | پیکربندی تنظیمات و hookهای AiraCode توی یک نشست تعاملی. |
aira agents | مدیریت agentهای پیکربندیشده و تنظیمات واگذاری. |
aira mcp serve | اجرای AiraCode بهعنوان یک سرور MCP. |
aira config | بررسی یا بهروزرسانی مقادیر پیکربندی امن AiraCode. alias: aira settings. |
aira install [target] | نصب یا رفرش باینری مستقل AiraCode. |
aira extensions install [target] | نصب افزونهٔ مرورگر و ویرایشگر. [target] یکی از browser، ide یا all (پیشفرض: all). alias: aira extension. |
aira extensions status | نمایش اینکه کدام افزونه نصب است، در چه مسیری، و با چه نسخهای. |
aira update | بررسی بهروزرسانی و نصب در صورت وجود. |
aira update --dry-run | گزارش یک بهروزرسانی احتمالی بدون تغییر باینری، aliasها، یا config. |
aira upgrade | alias سازگاری برای aira update. |
aira plugin | مدیریت پلاگینها و marketplaceها. alias: aira plugins. |
Slash commandها
/help | نمایش راهنما و slash commandهای موجود در حالت print. |
/balance | نمایش موجودی آیراکردیت و tier تو. |
/credits [days] | نمایش تفکیک مصرف آیراکردیت، مثلاً /credits 30. |
/usage [days] | نمایش مصرف حساب آیرا و بودجهٔ درخواست. |
/topup | باز کردن صفحهٔ شارژ آیراکردیت. |
/extra-usage | تنظیم مصرف اضافه تا وقتی به سقف رسیدی کار ادامه پیدا کنه. |
/stickers | باز کردن استیکرها، نشانها، و منابع برند AiraCode. |
/install-slack-app | اتصال Slack بهعنوان کانکتور MCP آیرا کد. |
/whoami | نمایش حساب آیرای فعلی. |
/goal [action] [text] | تنظیم یا بررسی یک هدف پایدار پروژه توی .aira/goal.json. |
/workflow <objective> | پیشنمایش یک workflow مسیریابیشده با مدل، همراه با برنامهریزی بودجه و connection. |
/deep-research <question> | پیشنمایش یک workflow تحقیق عمیقِ ارجاعدار که به aira-deep مسیریابی میشه. |
/genimage [options] <prompt> | تولید یا dry-run یک تصویر با مسیریابی provider و متادیتای مصرف. --persian presetهای ui، brand، editorial، icon و گزینههای --no-text و --exact-text دارد. |
/persian-dev [audit|font|copy|image|visual] [task] | راهنمای RTL، اسکن audit مسیر، فونت فارسی، localization، پرامپت تصویر فارسی، و برنامهٔ visual check. alias: /rtl، /fa-dev، /farsi-dev. |
/remote-control [status|help] | بررسی راهاندازی و مسیریابی Remote Control. alias: /rc. |
/model [model] | نمایش یا تنظیم مدل نشست فعلی. alias: /mod. |
/tag <tag-name> | روشن/خاموش کردن یک تگ قابلجستوجو روی نشست فعلی برای فیلتر آسانتر هنگام resume. |
/batch <instruction> | تحقیق و برنامهریزی یک تغییر بزرگ، بعد اجرای اون روی agentهای worktree ایزوله. |
/compact [instructions] | پاک کردن تاریخچهٔ گفتوگو با نگهداشتن یک خلاصه توی context. |
/context | نمایش مصرف context فعلی. |
/cost | نمایش هزینه و مدت کل نشست فعلی، وقتی ردیابی هزینهٔ محلی در دسترس باشه. |
/copy | توضیح اینکه چطور توی AiraCode تعاملی پاسخها رو کپی کنی. |
/debug [issue description] | روشن کردن لاگ debug برای این نشست و کمک به تشخیص یک مشکل. |
/insights | ساخت یک گزارش تحلیلی از نشستهای AiraCode تو. |
/init | ساخت یا بهروزرسانی راهنمای پروژهٔ AIRA.md. |
/passes | مرور passهای حساب آیرا. |
/release-notes | دیدن release noteهای نسخهٔ نصبشده و انتشارهای اخیر. |
/stats [7d|30d|all] | نمایش آمار مصرف و فعالیت AiraCode. |
/keybindings | باز کردن یا ساخت ~/.aira/keybindings.json برای شخصیسازی کلیدهای میانبر. |
/update-config | پیکربندی harness آیرا کد از طریق settings.json. |
/doctor | اجرای عیبیابی نصب AiraCode. |
/import-settings [source] [options] | وارد کردن تنظیمات سازگار از دستیارهای کدنویسی دیگه. alias: /import-config. |
/pr-comments | گرفتن کامنتهای یک pull request در GitHub. |
/review | ریویو یک pull request یا تغییرات فعلی. |
/security-review | ریویو تغییرات در انتظار branch برای مشکلات امنیتی. |
/simplify | ریویو کد تغییریافته از نظر استفادهٔ مجدد، کیفیت، و کارایی، بعد رفع مشکلات پیداشده. |
فرمانهای سفارشی
میتونی slash commandهای سفارشی توی ~/.aira/commands/ یا دایرکتوری محلی پروژه .aira/commands/ بسازی. هر.md فایل یک فرمان میشه:
# ~/.aira/commands/review.md --- description: Review the current PR allowed-tools: Read, Grep, Bash(git diff:*) --- # Review Inspect the current PR. Find security issues, bugs, and code-quality risks. Output structure: - Critical: [...] - Suggestions: [...] - Style: [...]
بعد توی یک نشست /review تایپ کن. AiraCode پرامپت رو باز میکنه و permissionهای اعلامشدهٔ ابزار رو اعمال میکنه.