اولین نشست

بعد از ورود چی اجرا کنی، تفاوت حالت تعاملی و headless، و چطور خارج بشی.

دو حالت

تعاملی: aira رو بدون پرامپت اجرا کن. AiraCode رابط نشست ترمینال رو باز می‌کنه و تا وقتی خارج بشی context رو نگه می‌داره.
headless: aira -p "prompt" رو اجرا کن. AiraCode یک جواب چاپ می‌کنه و خارج می‌شه — که برای اسکریپت‌نویسی و CI بهترینه.

مثال‌های کاربردی

# Explain a file
aira -p "Explain what auth/router.py does."

# Refactor several files with the coding lane
aira -p "Convert this component from useState to useReducer." \
     --model aira-code

# Run tests and summarize failures
aira -p "Run pnpm test and summarize the failing tests."

# Debug with a larger reasoning budget
aira --effort medium -p "Why does this panic only happen in production?"

# Pipe structured output
aira -p "List every TODO in this project." --output-format json | jq

Slash command‌ها

توی یک نشست تعاملی، / رو تایپ کن تا پیشنهاد فرمان‌ها باز بشه. همون نام فرمان‌ها توی حالت headless با aira -p هم کار می‌کنن، به‌شرطی که /help اون فرمان رو لیست کرده باشه.

/help — نمایش فرمان‌های موجود.
/model — نمایش یا تنظیم مدل این نشست.
/compact — خلاصه‌سازی context فعلی و ادامه.
/context — نمایش مصرف context فعلی.
/balance، /usage، و /credits — بررسی وضعیت اعتبار حساب.
/goal — تنظیم یا بررسی هدف پایدار پروژه.
/workflow و /deep-research — پیش‌نمایش پرامپت‌های workflow مسیریابی‌شده.
/doctor — بررسی سلامت نصب و به‌روزرسان.

برای فهرست فعلی فرمان‌های حالت print، aira -p /help بزن، یا برای subcommand‌های سطح‌بالای CLI، aira help بزن.

حالت برنامه‌ریزی

برای کارهای پیچیده، از AiraCode بخواه قبل از ادیت یک پلن بنویسه. توی رابط تعاملی Shift+Tab بزن، یا اجراهای headless رو با --permission-mode plan شروع کن.

خروج

Ctrl+C بزن. اگه فرمانی در حال اجراست، فشار اول لغوش می‌کنه؛ وقتی idle باشه، از نشست خارج می‌شه.
وقتی کار اجرای headless تموم شد، تب یا پروسهٔ ترمینال رو ببند.