AiraCode

اولین ابزار کدنویسی بومی ایران · The first Iran-native agentic coding CLI with persistent cognitive memory.

Built for Iranian developers. Works through Iran's internet restrictions — no extra setup needed. Top up your wallet with a domestic Rial card. Persistent memory through CogX so you never re-explain your project twice.

curl -fsSL https://airachat.ir/airacode/install.sh | bash
aira login
aira

Why AiraCode

• 🇮🇷 Works through Iran's internet restrictions. The CLI talks to app.airachat.ir, an in-country edge that handles routing to global model providers on your behalf. When the wider network is slow or blocked, AiraCode still answers.
• 🧠 Persistent cognitive memory. Aira remembers your projects, decisions, codebase quirks across sessions, devices, and weeks. Walk away for a month, come back — she already knows. No flag to flip, no opt-in.
• 💵 Rial payment, AiraCredit unit. Top up your AiraChat wallet from a domestic Shetab card. Spend in AiraCredits (AC) — Aira's transparent in-house unit. Every turn shows the AC cost.
• 🎯 Task-based model selection. Pick by what you're doing — Code, Deep Think, Docs, Fast — not by aira-gpt5 or aira-opus. Underlying provider is hidden by default.
• 💬 Persian-native. RTL terminal, Persian system prompts, Vazirmatn fonts. Speak Persian, get Persian back; speak English, get English.
• 🌐 Sessions in the browser too. Long-running agent runs at airachat.ir/airacode so your terminal stays free.

Install

One-liner:

curl -fsSL https://airachat.ir/airacode/install.sh | bash

Auto-detects platform (macOS, Linux, WSL), installs Node and bun if needed, pulls the binary from npm.

Or with npm directly:

npm install -g @airachat/airacode

Verify:

aira --version
# → 0.1.x (AiraCode)

First-run

aira login           # opens app.airachat.ir OAuth in your browser
aira                 # start an interactive session

The first aira login connects your AiraChat account — that's your billing identity, Rial wallet, and persistent memory. Already an airachat.ir user? You're already signed up.

Everyday use

aira                                  # interactive REPL
aira -p "explain this codebase"       # one-shot prompt
aira --model aira-deep -p "refactor"  # pick a heavier level for one turn
aira balance                          # AC balance + plan + budget
aira credits 7                        # 7-day AC usage breakdown
aira topup                            # open the topup page

Inside the REPL:

/balance          # موجودی + پلن
/credits 30       # ۳۰ روز مصرف
/topup            # شارژ
/model            # انتخاب سطح هوشمند
/memory           # حافظهٔ این پروژه

Aira Levels (task-based model selection)

--model <alias> accepts any of these task-based levels. Pick by what you're doing, not by which underlying model. AiraCode picks the right provider behind the scenes.

| Level | Badge | Best for | |---|---|---| | aira-balanced (default) | پیشنهادی | day-to-day coding, balanced quality / speed / cost | | aira-deep | حرفه‌ای | complex reasoning, architecture, strategic planning | | aira-code | حرفه‌ای | refactoring, debugging, agentic tool use | | aira-docs | حرفه‌ای | long context, PDFs, image / file analysis | | aira-fast | سریع | quick answers, titles, summaries, intent detection | | aira-lite | اقتصادی | classification, extraction, high-volume light work | | aira-max | پرچم‌دار | top quality, multi-pass reasoning, deepest recall |

Each level bundles model + recall depth + thinking budget + chat context — not just a model choice. Custom dial available in airachat.ir/settings/level.

Full catalog inside any session: /model. Power users can pin a specific underlying model via the advanced picker.

BYOK — Bring Your Own Key

If you'd rather pay inference cost directly to Anthropic / OpenAI / OpenRouter and use AiraCode purely as the memory + cognition layer:

export ANTHROPIC_API_KEY="sk-ant-..."          # or OPENAI_API_KEY, OPENROUTER_API_KEY
aira                                           # AiraCode now routes inference via your key

Only memory operations (recall, save) consume AiraCredits. Token costs go directly to the provider. Configure persistent BYOK in airachat.ir/settings/level.

Pricing

Pay in AiraCredits (AC) — Aira's in-house unit, topped up with Rial via Shetab card (Zibal, IDPay, ZarinPal).

Plans:

• رایگان (Free) — حافظه + تفکر سبک. سهمیهٔ روزانهٔ محدود. مناسب برای آشنایی.
• دوست (Doost) — اشتراک ماهانهٔ Rial، هدیهٔ AC ماهانه، ۲۰۰ پیام روزانه، صدا + TTS.
• رفیق (Rafiq) — اشتراک Rial، AC ماهانهٔ بیشتر، پیام نامحدود، حافظهٔ عمیق‌تر، اولویت پشتیبانی.
• یار (Yaar) — اشتراک Rial، AC ماهانهٔ پرحجم، همه چیز نامحدود، دسترسی به سطح Aira Max، قابلیت‌های آزمایشی.
• PAYG — بدون اشتراک، فقط AC از کیف پول مصرف می‌شود.

Top-up packs: ۱۰۰ هزار / ۵۰۰ هزار / ۱ میلیون / ۵ میلیون / ۱۰ میلیون تومان — به AC تبدیل و قفل می‌شود در لحظهٔ خرید.

Live pricing + AC quotes: airachat.ir/settings/billing.

Docs & support

• Getting started: airachat.ir/airacode/docs/getting-started
• Memory (CogX): airachat.ir/airacode/docs/memory
• Aira Levels: airachat.ir/airacode/docs/levels
• BYOK: airachat.ir/airacode/docs/byok
• Connecting MCP servers: airachat.ir/airacode/docs/mcp
• OAuth / API keys: airachat.ir/developer/keys
• Web sessions: airachat.ir/airacode/sessions
• Developer console: airachat.ir/developer
• Issues: github.com/airachat/airacode/issues
• Email: [email protected]

License

Apache 2.0. AiraCode is a substantially-modified Iranian product. Full attribution in LICENSE.