TUI

يوفّر OpenCode واجهة terminal تفاعلية (TUI) للعمل على مشاريعك باستخدام LLM.

يؤدي تشغيل OpenCode إلى بدء واجهة TUI للدليل الحالي.

opencode

أو يمكنك تشغيلها لدليل عمل محدد.

opencode /path/to/project

بعد الدخول إلى واجهة TUI، يمكنك إرسال رسالة كطلب.

Give me a quick summary of the codebase.

---

مراجع الملفات

يمكنك الإشارة إلى الملفات في رسائلك باستخدام @. يُجري ذلك بحثا ضبابيا عن الملفات ضمن دليل العمل الحالي.

نصيحة

يمكنك أيضا استخدام @ للإشارة إلى الملفات في رسائلك.

How is auth handled in @packages/functions/src/api/index.ts?

تُضاف محتويات الملف إلى المحادثة تلقائيا.

---

أوامر Bash

ابدأ الرسالة بـ ! لتشغيل أمر في shell.

!ls -la

يُضاف خرج الأمر إلى المحادثة كنتيجة أداة.

---

الأوامر

عند استخدام واجهة OpenCode في terminal، يمكنك كتابة / متبوعة باسم أمر لتنفيذ الإجراءات بسرعة. مثلا:

/help

تملك معظم الأوامر أيضا اختصارا باستخدام ctrl+x كمفتاح قائد، حيث إن ctrl+x هو المفتاح القائد الافتراضي. اعرف المزيد.

فيما يلي جميع أوامر الشرطة المائلة المتاحة:

---

connect

أضف موفّرا إلى OpenCode. يتيح لك اختيار أحد الموفّرين المتاحين وإضافة مفاتيح API الخاصة بهم.

/connect

---

compact

قم بضغط الجلسة الحالية. الاسم المستعار: /summarize

/compact

اختصار لوحة المفاتيح: ctrl+x c

---

details

بدّل عرض تفاصيل تنفيذ الأدوات.

/details

اختصار لوحة المفاتيح: ctrl+x d

---

editor

افتح محررا خارجيا لكتابة الرسائل. يستخدم المحرر المحدد في متغير البيئة EDITOR. اعرف المزيد.

/editor

اختصار لوحة المفاتيح: ctrl+x e

---

exit

اخرج من OpenCode. الأسماء المستعارة: /quit, /q

/exit

اختصار لوحة المفاتيح: ctrl+x q

---

export

صدّر المحادثة الحالية إلى Markdown وافتحها في المحرر الافتراضي لديك. يستخدم المحرر المحدد في متغير البيئة EDITOR. اعرف المزيد.

/export

اختصار لوحة المفاتيح: ctrl+x x

---

help

اعرض مربع حوار المساعدة.

/help

اختصار لوحة المفاتيح: ctrl+x h

---

init

أنشئ ملف AGENTS.md أو حدّثه. اعرف المزيد.

/init

اختصار لوحة المفاتيح: ctrl+x i

---

models

اعرض النماذج المتاحة.

/models

اختصار لوحة المفاتيح: ctrl+x m

---

new

ابدأ جلسة جديدة. الاسم المستعار: /clear

/new

اختصار لوحة المفاتيح: ctrl+x n

---

redo

أعِد تنفيذ رسالة تم التراجع عنها سابقا. متاح فقط بعد استخدام /undo.

نصيحة

ستتم أيضا استعادة أي تغييرات على الملفات.

داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك مستودع Git.

/redo

اختصار لوحة المفاتيح: ctrl+x r

---

sessions

اعرض الجلسات وبدّل بينها. الأسماء المستعارة: /resume, /continue

/sessions

اختصار لوحة المفاتيح: ctrl+x l

---

share

شارك الجلسة الحالية. اعرف المزيد.

/share

اختصار لوحة المفاتيح: ctrl+x s

---

themes

اعرض السمات المتاحة.

/theme

اختصار لوحة المفاتيح: ctrl+x t

---

thinking

بدّل إظهار كتل التفكير/الاستدلال في المحادثة. عند تفعيله، يمكنك رؤية عملية استدلال النموذج للنماذج التي تدعم التفكير الموسّع.

ملاحظة

يتحكم هذا الأمر فقط فيما إذا كانت كتل التفكير تُعرض؛ ولا يفعّل أو يعطّل قدرات الاستدلال في النموذج. لتبديل قدرات الاستدلال فعليا، استخدم ctrl+t للتنقّل بين إصدارات النموذج.

/thinking

---

undo

تراجع عن آخر رسالة في المحادثة. يزيل أحدث رسالة للمستخدم، وكل الردود اللاحقة، وأي تغييرات على الملفات.

نصيحة

سيتم أيضا التراجع عن أي تغييرات على الملفات.

داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك مستودع Git.

/undo

اختصار لوحة المفاتيح: ctrl+x u

---

unshare

ألغِ مشاركة الجلسة الحالية. اعرف المزيد.

/unshare

---

إعداد المحرر

يستخدم الأمران /editor و/export المحرر المحدد في متغير البيئة EDITOR.

Linux/macOS

# Example for nano or vim
export EDITOR=nano
export EDITOR=vim

# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

لجعل ذلك دائما، أضف هذا إلى ملف تهيئة shell لديك؛ ~/.bashrc، ~/.zshrc، إلخ.

Windows (CMD)

set EDITOR=notepad

# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

لجعل ذلك دائما، استخدم System Properties > Environment Variables.

Windows (PowerShell)

$env:EDITOR = "notepad"

# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

لجعل ذلك دائما، أضف هذا إلى ملف تهيئة PowerShell لديك.

تتضمن خيارات المحررات الشائعة ما يلي:

• code - Visual Studio Code
• cursor - Cursor
• windsurf - Windsurf
• nvim - محرر Neovim
• vim - محرر Vim
• nano - محرر Nano
• notepad - Windows Notepad
• subl - Sublime Text

ملاحظة

تحتاج بعض المحررات مثل VS Code إلى التشغيل مع الخيار --wait.

تحتاج بعض المحررات إلى وسائط CLI لتعمل بوضع الحجب. يجعل الخيار --wait عملية المحرر تنتظر حتى يتم إغلاقها.

---

الإعداد

يمكنك تخصيص سلوك واجهة TUI عبر ملف إعدادات OpenCode.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

الخيارات

• scroll_acceleration - فعّل تسارع التمرير على نمط macOS لتمرير سلس وطبيعي. عند تفعيله، تزداد سرعة التمرير مع إيماءات التمرير السريعة وتبقى دقيقة للحركات الأبطأ. يتقدّم هذا الإعداد على scroll_speed ويستبدله عند تفعيله.
• scroll_speed - يتحكم في سرعة تمرير واجهة TUI عند استخدام أوامر التمرير (الحد الأدنى: 1). القيمة الافتراضية هي 3. ملاحظة: يتم تجاهل هذا إذا تم ضبط scroll_acceleration.enabled على true.

---

التخصيص

يمكنك تخصيص جوانب مختلفة من عرض واجهة TUI باستخدام لوحة الأوامر (ctrl+x h أو /help). تبقى هذه الإعدادات محفوظة عبر عمليات إعادة التشغيل.

---

عرض اسم المستخدم

بدّل ما إذا كان اسم المستخدم يظهر في رسائل الدردشة. يمكنك الوصول إلى هذا عبر:

• لوحة الأوامر: ابحث عن “username” أو “hide username”
• يُحفظ الإعداد تلقائيا وسيتم تذكره عبر جلسات واجهة TUI