# سطر الأوامر

> أدر تاروت من سطر الأوامر باستخدام @tarout/cli

# سطر الأوامر

واجهة سطر أوامر تاروت (`@tarout/cli`) تتيح لك إدارة التطبيقات وقواعد البيانات والنطاقات وعمليات النشر من الطرفية.

## التثبيت

```bash
curl -fsSL https://tarout.sa/install.sh | sh
# أو
npm install -g @tarout/cli
```

## المصادقة

```bash
# تسجيل الدخول لحساب تاروت
tarout login

# التحقق من حالة المصادقة
tarout whoami

# تسجيل الخروج
tarout logout
```

## البدء السريع

```bash
# انتقل إلى مشروعك
cd my-app

# افحص المشروع ثم انشره: من مستودع GitHub إن وُجد (فيعيد كل push النشر)، وإلا برفع هذا المجلد
tarout deploy --wait

# عرض سجلات النشر إذا احتجت الرجوع لها لاحقًا
tarout deploy:logs <deployment-id> --follow
```

يطلب `tarout deploy` تسجيل الدخول أو إنشاء الحساب عند عدم وجود جلسة محلية. قبل إنشاء التطبيق، يفحص المجلد الحالي بحثًا عن قاعدة بيانات، وتخزين ملفات، وGit. إذا اكتشف Git، يمكنك استخدام مسار رفع المجلد الحالي افتراضيًا أو اختيار مصدر Git provider مضبوط مسبقًا.

## الإعدادات

بيانات الاعتماد **لكل مشروع**. الأمر `tarout login` يحفظها بجانب مشروعك، لا في
ملف تعريف على مستوى الجهاز، فربط مشروع ثانٍ بحساب آخر لا يغيّر حساب المشروع الأول.

- **بيانات اعتماد المشروع**: `.tarout/auth.json` - رمز API والحساب الذي يخصه.
  يُنشأ بصلاحية `0600` داخل مجلد بصلاحية `0700`، ويُستثنى تلقائياً من Git ومن
  أرشيف النشر. يُعثر عليه بالصعود من المجلد الحالي، فيعمل من أي مجلد فرعي.
- **ربط المشروع**: `.tarout/project.json` - التطبيق الذي ينشر إليه هذا المجلد.
- **ملف تعريف على مستوى الجهاز** (اختياري، `tarout login --global`): يُخزَّن في
  مجلد إعدادات النظام - `~/Library/Preferences/tarout-nodejs/config.json` على
  macOS، و`~/.config/tarout-nodejs/config.json` على Linux،
  و`%APPDATA%\tarout-nodejs\Config\config.json` على Windows. بيانات اعتماد
  المشروع تتقدم عليه دائماً، و`--global-auth` يتجاهل طبقة المشروع لأمر واحد.

## متغيرات البيئة

واجهة سطر الأوامر تستجيب لهذه المتغيرات:

| المتغير | الوصف |
|---------|-------|
| `TAROUT_API_URL` | تغيير عنوان API (مسموح فقط بـ `tarout.sa` و`*.tarout.sa` والعناوين المحلية) |
| `TAROUT_NO_BROWSER` | عدم محاولة فتح المتصفح إطلاقاً |
| `TAROUT_NO_UPDATE_CHECK` | تخطي فحص التحديث التلقائي |

## اعرف المزيد

- [مرجع الأوامر](https://tarout.sa/docs/cli/commands) - القائمة الكاملة للأوامر المتاحة.
- [مرجع API](https://tarout.sa/docs/api) - توثيق REST API.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md