دليل OpenCode الشامل (OpenCode Comprehensive Guide)

# التثبيت العالمي
npm install -g @ohmyopencode/cli

# التهيئة الأولية
opencode init

# سحب الصورة
docker pull ohmyopencode/cli

# التشغيل
docker run -it ohmyopencode/cli

# استنساخ المستودع
git clone https://github.com/ohmyopencode/opencode
cd opencode

# التثبيت
npm install
npm run build
npm link

opencode config

opencode project create "تطبيق Todo مع Next.js"

opencode chat

أنت: كيف يمكنني إضافة المصادقة لتطبيقي؟

OpenCode: لإضافة المصادقة، يمكنك استخدام:

1. NextAuth.js - الحل الأكثر شعبية لـ Next.js
2. Clerk - خدمة مصادقة جاهزة
3. Supabase Auth - مصادقة مدمجة مع قاعدة البيانات

أي واحد تريد أن أساعدك في تنفيذه؟

opencode debug --error "TypeError: Cannot read property 'id' of undefined"

opencode review src/components/UserCard.tsx

┌─────────────────────────────────────────┐
│         User Request                   │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│      📋 Planner Agent                  │
│  - يحلل الطلب                          │
│  - يقسم المهام                         │
│  - يحدد الترتيب                        │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│      💻 Coder Agent                     │
│  - يكتب الكود                          │
│  - ينشئ الملفات                        │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│      ✅ Reviewer Agent                  │
│  - يراجع الجودة                        │
│  - يقترح تحسينات                       │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│      🧪 Tester Agent                    │
│  - ينشئ اختبارات                       │
│  - يتحقق من التغطية                    │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│      🐛 Debugger Agent (عند الحاجة)    │
│  - يحدد الأخطاء                        │
│  - يقترح حلولاً                        │
└─────────────┬───────────────────────────┘
              │
              ▼
         ✨ Final Output

# تحويل ملفات JS إلى TypeScript
opencode refactor src/legacy --to typescript

# إضافة TypeScript strict mode
opencode refactor . --add-strict-mode

# تحويل Class Components إلى Functional Components
opencode refactor src/components --to-functional

# الوضع التفاعلي
opencode agent --interactive

# الوضع المستقل (autonomous)
opencode agent "أضف ميزة السلة الشرائية"

# .opencode-rules
project:
  name: "تطبيقي"
  type: "Next.js 14 + TypeScript"
  description: "تطبيق SaaS للمهام"

coding_style:
  - "استخدم TypeScript strict mode"
  - "فضّل المكونات الوظيفية"
  - "استخدم Tailwind CSS"
  - "اكتب اختبارات لجميع utilities"
  - "اتبع convention: camelCase للمتغيرات"

ai_preferences:
  model: "claude-3-opus"
  temperature: 0.2
  max_tokens: 4000
  timeout: 30000

agents:
  planner: "claude-3-opus"
  coder: "gpt-4"
  reviewer: "claude-3-sonnet"
  tester: "gpt-4"

paths:
  src: "./src"
  tests: "./tests"
  output: "./dist"

ignore:
  - "node_modules/**"
  - ".next/**"
  - "dist/**"
  - "*.min.js"

# عرض النماذج المتاحة
opencode models list

# تعيين النموذج الافتراضي
opencode config set model claude-3-opus

# تعيين نماذج لوكلاء مختلفين
opencode config set agent.planner claude-3-opus
opencode config set agent.coder gpt-4
opencode config set agent.reviewer claude-3-sonnet

# إعداد Ollama
opencode config set provider ollama
opencode config set model codellama

# إعداد LM Studio
opencode config set provider lmstudio
opencode config set model local-model
opencode config set apiEndpoint http://localhost:1234

opencode project create "SaaS Starter Kit"

opencode learn "بناء blockchain من الصفر"

opencode debug --file src/utils/api.ts --error "ECONNREFUSED"

opencode test src/services/auth.ts

opencode document src/api/users.ts

# قدم سياقاً واضحاً
opencode ask "كيف يمكنني إضافة REST API لمشروع Next.js الخاص بي؟"

# استخدم ملفات مرجعية محددة
opencode refactor src/components/Button.tsx --to-functional

# راجع الكود قبل الموافقة
opencode review src --interactive

# استخدم النموذج المناسب للمهمة
opencode chat --model claude-3-haiku  # للأسئلة البسيطة والسريعة
opencode build --model claude-3-opus   # للمهام المعقدة

# جرّب اقتراحات OpenCode
opencode suggest "كيف يمكنني تحسين أداء تطبيقي؟"

# 🚫 لا تنسخ كوداً بدون فهمه
opencode generate "كود معقد" → انسخ وفقط ❌

# 🚫 لا تستخدمه لكود حساس
opencode refactor src/api/keys.ts ❌  # مفاتيح API سرية

# 🚫 لا تتوقع الكمال من المحاولة الأولى
opencode build "تطبيق كامل" → يتوقع خالٍ من الأخطاء ❌

# 🚫 لا تتخطى الاختبارات
opencode generate "كود" → لا يختبره ❌

# 🚫 لا تستخدمه للقرصنة أو أنشطة غير قانونية
opencode help "كيف أخترق موقع؟" ❌

opencode install vscode

opencode install cursor

opencode install nvim

# إعادة هيكلة عبر قاعدة الكود بالكامل
opencode refactor "تحويل جميع Class Components إلى Functional Components"

# إضافة ميزة عبر ملفات متعددة
opencode feature "أضف Dark Mode"
# ينشئ: hooks, context, components, utils

# الوضع المستقل - يعمل حتى تكتمل المهمة
opencode agent --autonomous "ابنِ REST API مع MongoDB"

# الوضع الخاضع للإشراف - يطلب الموافقة في كل خطوة
opencode agent --interactive "إعادة هيكلة هذا الملف"

# يقرأ OpenCode:
# - قاعدة الكود الخاصة بك
# - Git history
# - Package dependencies
# - ملف .opencode-rules
# - حالة المحرر النشطة

opencode ask "لماذا يعيد هذا المكون Rendering؟"
# يستخدم كل السياق للإجابة بدقة

# تأكد من التثبيت العالمي
npm install -g @ohmyopencode/cli

# تأكد من PATH
echo $PATH  # يجب أن يحتوي على مسار npm

# أعِ تعيين مفتاح API
opencode config set apikey YOUR_NEW_KEY

# تحقق من المفتاح
opencode config get apikey

# اعرض النماذج المتاحة
opencode models list

# اختر نموذجاً مختلفاً
opencode config set model gpt-3.5-turbo

# تأكد من تشغيل Ollama
ollama list

# شغّل النموذج
ollama run codellama

# تحقق من الاتصال
curl http://localhost:11434/api/tags

# مساعدة عامة
opencode --help

# مساعدة لأمر محدد
opencode build --help
opencode chat --help

# الإبلاغ عن مشكلة
gh issue create --repo ohmyopencode/opencode

# أوامر أساسية
opencode chat                    # محادثة تفاعلية
opencode ask "سؤال"             # سؤال مباشر
opencode build "طلب"            # بناء ميزة
opencode refactor path          # إعادة هيكلة
opencode debug --error "..."    # تصحيح أخطاء
opencode review path            # مراجعة كود

# الأوامر الشائعة
opencode init                   # إعداد أولي
opencode config                 # إعدادات
opencode models list            # عرض النماذج

# مع الخيارات
opencode build "طلب" --model claude-3-opus     # نموذج محدد
opencode agent --interactive                  # تفاعلي
opencode refactor path --to typescript        # تحويل إلى TS

# تثبيت Oh My OpenCode
opencode plugin add oh-my-opencode

# أو التثبيت العالمي
npm install -g oh-my-opencode

# كل وكيل متخصص بمهمة
opencode agent architect "صمم بنية تطبيق e-commerce"
opencode agent security "افحص الكود للثغرات"
opencode agent performance "حسّن هذا الملف"

# تثبيت الإضافة
opencode plugin add antigravity-auth

# ربط حسابك
opencode auth connect antigravity

✅ استخدام Claude Opus 4.5 مجاناً
✅ استخدام Gemini 3 Pro مجاناً
✅ استخدام Gemini 3 Flash مجاناً
✅ لا حاجة لمفاتيح API مدفوعة

# تفعيل MCP
opencode mcp init

# تفعيل Skills
opencode skills enable web-search
opencode skills enable code-executor
opencode skills enable database-query

الطريقة: استخدام نموذج GLM بدلاً من Claude Opus

التكلفة الأصلية: $20 - $200/شهر
التكلفة الجديدة: $6 - $30/شهر

# بعد تثبيت Claude Code
claude config set model glm-4.7

# أو في ملف الإعدادات
# ~/.claude-config
model: glm-4.7