فرمان‌ها

مرجع کامل CLI flags، subcommands، و slash commands درون نشست.

CLI flags

-p, --print <prompt>حالت headless. خروجی روی stdout، خروج بعد از یک turn.
--model <id>مدل (alias یا model ID).
--output-format <fmt>text | json | stream-json.
--thinking <low|medium|high>بودجهٔ thinking برای مدل‌هایی که پشتیبانی می‌کنن.
--permission-mode <mode>default | plan | bypassPermissions | auto.
--dangerously-skip-permissionsتمام prompt‌های tool رو رد می‌کنه (فقط CI).
--bareحالت hermetic. هیچ keychain/config. فقط env.
-d, --debug [filter]debug mode با فیلتر اختیاری (مثلاً "api,hooks").
--mcp-config <path>فایل کانفیگ MCP اختصاصی این session.
--add-dir <path>افزودن دایرکتوری اضافی به permission scope.
-v, --versionنسخه.
-h, --helpراهنما.

Subcommands

aira loginOAuth flow.
aira logoutپاک کردن توکن.
aira doctorتشخیص سلامت نصب.
aira mcp serveAiraCode رو به‌عنوان سرور MCP اجرا می‌کنه.
aira ssh <host>AiraCode رو روی هاست remote اجرا می‌کنه، auth از local tunnel می‌شه.
aira serverحالت persistent HTTP server (preview).
aira install [target]نصب nativeBinary (وقتی موجود شد).
aira pluginمدیریت پلاگین‌ها.

Slash commands (داخل نشست)

/helpراهنمای کامل، شامل تمام slash command‌ها.
/loginشروع/تکرار OAuth flow.
/logoutپاک کردن توکن از Keychain.
/whoamiنمایش کاربر فعلی و subscription tier.
/modelانتخاب مدل برای نشست فعلی (یا با --model در CLI).
/clearپاک کردن context بدون خروج از نشست.
/compactفشرده‌سازی context طولانی — مفید قبل از turn سنگین.
/costگزارش هزینهٔ توکن مصرف‌شده در این نشست.
/diffنمایش diff تمام تغییرات اعمال‌شدهٔ AiraCode در این نشست.
/memoryلیست، ادیت، و حذف حافظه‌های پروژه.
/resumeبازگرداندن آخرین نشست با کامل بودن context.
/shareساختن لینک share برای نشست فعلی (read-only).
/configباز کردن settings.json در $EDITOR.
/doctorتشخیص مشکلات نصب و auto-updater.
/mcpمدیریت سرورهای MCP — افزودن، حذف، لیست.
/pluginمدیریت پلاگین‌ها و marketplaces.
/skillsلیست و فعال/غیرفعال‌سازی skill‌ها.
/tasksمدیریت taskها (created/in_progress/completed).
/vimفعال‌سازی vim mode در editor inline.
/themeتغییر theme — light/dark/auto.
/contextنمایش وضعیت context window و توکن‌های مصرف‌شده.
/pr_commentsمشاهدهٔ کامنت‌های PR (gh integration لازمه).
/desktopانتقال به اپ desktop آیراکد (آینده).
/mobileانتقال به اپ موبایل آیراچت (برای handoff طرح‌ها).
/exitخروج از نشست.

دستور سفارشی

می‌تونی slash command‌های سفارشی توی ~/.aira/commands/ یا.aira/commands/ پروژه بسازی. هر فایل .md یک دستور می‌شه:

# ~/.aira/commands/review.md
---
description: مرور سریع PR فعلی
allowed-tools: Read, Grep, Bash(git diff:*)
---

# Review

PR فعلی رو نگاه کن. نکات امنیتی، bugها، و کیفیت کد رو پیدا کن.
خروجی ساختار:
- Critical: [...]
- Suggestions: [...]
- Style: [...]

بعد توی نشست تایپ کن /review — AiraCode prompt رو با permission‌های اعلام‌شده اجرا می‌کنه.