فرمان‌ها

مرجع پرچم‌های 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 و مسیریابی برای 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 updateبررسی به‌روزرسانی و نصب در صورت وجود.
aira update --dry-runگزارش یک به‌روزرسانی احتمالی بدون تغییر باینری، alias‌ها، یا config.
aira upgradealias سازگاری برای 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‌های اعلام‌شدهٔ ابزار رو اعمال می‌کنه.