1 files changed, 48 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/ar/ide.mdx b/packages/web/src/content/docs/ar/ide.mdx
new file mode 100644
index 000000000..676c5717a
--- /dev/null
+++ b/packages/web/src/content/docs/ar/ide.mdx
@@ -0,0 +1,48 @@
+---
+title: IDE
+description: امتداد OpenCode لـ VS Code و Cursor وغيرها من بيئات التطوير
+---
+
+يتكامل OpenCode مع VS Code و Cursor أو أي IDE يدعم الطرفية. ما عليك سوى تشغيل `opencode` في الطرفية للبدء.
+
+---
+
+## الاستخدام
+
+- **تشغيل سريع**: استخدم `Cmd+Esc` (Mac) أو `Ctrl+Esc` (Windows/Linux) لفتح OpenCode في عرض طرفية مقسّم، أو للتركيز على جلسة طرفية موجودة إذا كانت قيد التشغيل بالفعل.
+- **جلسة جديدة**: استخدم `Cmd+Shift+Esc` (Mac) أو `Ctrl+Shift+Esc` (Windows/Linux) لبدء جلسة طرفية جديدة لـ OpenCode حتى لو كانت هناك جلسة مفتوحة. يمكنك أيضا النقر على زر OpenCode في واجهة المستخدم.
+- **وعي بالسياق**: شارك تلقائيا تحديدك الحالي أو تبويبك مع OpenCode.
+- **اختصارات الإشارة إلى الملفات**: استخدم `Cmd+Option+K` (Mac) أو `Alt+Ctrl+K` (Linux/Windows) لإدراج مراجع الملفات. مثلا: `@File#L37-42`.
+
+---
+
+## التثبيت
+
+لتثبيت OpenCode على VS Code والتفرعات الشائعة مثل Cursor و Windsurf و VSCodium:
+
+1. افتح VS Code
+2. افتح الطرفية المدمجة
+3. شغّل `opencode` - سيتم تثبيت الامتداد تلقائيا
+
+أما إذا كنت تريد استخدام IDE الخاص بك عند تشغيل `/editor` أو `/export` من واجهة TUI، فستحتاج إلى ضبط `export EDITOR="code --wait"`. [اعرف المزيد](/docs/tui/#editor-setup).
+
+---
+
+### التثبيت اليدوي
+
+ابحث عن **OpenCode** في Extension Marketplace وانقر **Install**.
+
+---
+
+### استكشاف الأخطاء وإصلاحها
+
+إذا فشل تثبيت الامتداد تلقائيا:
+
+- تأكد من أنك تشغّل `opencode` داخل الطرفية المدمجة.
+- تأكد من تثبيت واجهة سطر الأوامر (CLI) الخاصة بـ IDE لديك:
+  - لـ VS Code: أمر `code`
+  - لـ Cursor: أمر `cursor`
+  - لـ Windsurf: أمر `windsurf`
+  - لـ VSCodium: أمر `codium`
+  - إذا لم تكن مثبتة، شغّل `Cmd+Shift+P` (Mac) أو `Ctrl+Shift+P` (Windows/Linux) وابحث عن "Shell Command: Install 'code' command in PATH" (أو ما يعادله في IDE لديك)
+- تأكد من أن VS Code لديه الصلاحية لتثبيت الامتدادات