مستندات AiraCode

هر چیزی که برای استفاده، یکپارچه‌سازی، و توسعهٔ روی AiraCode لازم داری.

AiraCode یک CLI کدنویسی هوش مصنوعی برای توسعه‌دهنده‌های ایرانی‌ست. این مستندات از پایه تا مرجع کامل API رو پوشش می‌ده. اگه تازه‌واردی، از «نصب و شروع» بخون.

محورها

برای دسترسی سریع به موضوعات اصلی:

چرا AiraCode؟ اگه باید توضیح بدی به همتیمی، مرور شروع هست.
هزینه و مدل: مدل پیش‌فرض aira-balanced، اما هر مدل رو می‌تونی انتخاب کنی — جزئیات.
حافظهٔ ماندگار: AIRA_REMOTE_MEMORY=1 و CogX کارها رو به‌خاطر می‌سپاره — راهنما.
پلاگین/افزونه: AiraCode از پروتکل MCP استاندارد پشتیبانی می‌کنه — افزودن سرور.

شروع

نصب و شروع

نصب یک‌خطی، پیش‌نیازها، و اولین اجرا.

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

فلوی OAuth با کد یک‌بارمصرف از طریق آیراچت.

اولین نشست

فرمان‌های پایه، حالت‌های تعاملی و headless.

پیکربندی

انتخاب مدل

alias‌ها، env vars، تخصیص مدل بر اساس task_type.

حافظهٔ CogX

حافظهٔ راه‌دور، نوع‌های حافظه، recall با intent.

متغیرهای محیطی

فهرست کامل AIRA_* و سازگارهای ANTHROPIC_*.

پوشهٔ ~/.aira

مهاجرت از ~/.claude، ساختار درون پوشه.

API و یکپارچگی

Gateway آیراکد

پروکسی Anthropic Messages، مدل‌سازی، allowlist.

OAuth برای CLI

پروتکل کامل /auth/oauth/* برای ابزارهای ثالث.

استفاده به‌عنوان SDK

فراخوانی aira از داخل اسکریپت‌های خودت.

حالت headless / CI

AIRA_API_KEY، خروجی JSON، اتوماسیون.

مراجع

فرمان‌ها

تمام فرمان‌های موجود aira و subcommand‌ها.

Bash، Read، Edit، Grep، Glob، Agent، MCP، LSP.

سرورهای MCP

افزودن سرور MCP، احراز هویت، scope محدودیت.

عیب‌یابی

خطاهای متداول و راه‌حل‌ها.