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

# مثال لـ nano أو vim
export EDITOR=nano
export EDITOR=vim

# للمحررات الرسومية، VS Code، Cursor، VSCodium، Windsurf، Zed، إلخ.
# قم بتضمين --wait
export EDITOR="code --wait"

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

Windows (CMD)

set EDITOR=notepad

# للمحررات الرسومية، VS Code، Cursor، VSCodium، Windsurf، Zed، إلخ.
# قم بتضمين --wait
set EDITOR=code --wait

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

Windows (PowerShell)

$env:EDITOR = "notepad"

# للمحررات الرسومية، VS Code، Cursor، VSCodium، Windsurf، Zed، إلخ.
# قم بتضمين --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 من خلال tui.json (أو tui.jsonc).

tui.json

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "leader_timeout": 2000,
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  },
  "scroll_speed": 3,
  "scroll_acceleration": {
    "enabled": false
  },
  "diff_style": "auto",
  "mouse": true,
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true,
    "volume": 0.4,
    "sound_pack": "opencode.default",
    "sounds": {
      "error": "./sounds/error.mp3"
    }
  }
}

هذا منفصل عن opencode.json، الذي يضبط سلوك الخادم ووقت التشغيل.

يتم دمج keybinds مع الاختصارات الافتراضية المدمجة، لذلك لا تحتاج إلا إلى ضبط الاختصارات التي تريد تغييرها.

الخيارات

• theme - يحدد سمة UI. اعرف المزيد.
• keybinds - يخصص اختصارات لوحة المفاتيح. اعرف المزيد.
• leader_timeout - يتحكم في مدة انتظار OpenCode بعد الضغط على leader key. القيمة الافتراضية 2000.
• scroll_acceleration.enabled - يفعّل تسارع التمرير على نمط macOS لتمرير سلس وطبيعي. عند تفعيله، تزداد سرعة التمرير مع إيماءات التمرير السريعة وتبقى دقيقة للحركات الأبطأ. يتقدّم هذا الإعداد على scroll_speed ويستبدله عند تفعيله.
• scroll_speed - يتحكم في سرعة تمرير TUI عند استخدام أوامر التمرير (الحد الأدنى: 0.001، ويدعم القيم العشرية). القيمة الافتراضية 3. ملاحظة: يتم تجاهل هذا إذا تم ضبط scroll_acceleration.enabled على true.
• diff_style - يتحكم في عرض الفروقات (diff). القيمة "auto" تتكيف مع عرض terminal، و"stacked" تعرض عمودًا واحدًا دائمًا.
• mouse - يفعّل أو يعطّل التقاط الماوس في TUI (القيمة الافتراضية: true). عند تعطيله، يتم الحفاظ على سلوك terminal الأصلي لتحديد النص والتمرير بالماوس.
• attention - يضبط desktop notifications والأصوات في TUI. معطل افتراضيًا.

استخدم OPENCODE_TUI_CONFIG لتحميل مسار إعدادات TUI مخصص.

Attention

تجعل ميزة Attention واجهة TUI تنبهك عندما ينتظر OpenCode ردًا منك، أو يحتاج إلى الموافقة على permission، أو يواجه session error، أو ينهي session. فعّلها باستخدام attention.enabled؛ تشغّل الأحداث المدمجة صوتًا عند حدوثها. لا تُرسل desktop notifications إلا عندما لا تكون نافذة terminal في المقدمة، ولا تُستخدم مع أحداث subagent.

• enabled - يفعّل جميع notifications والأصوات الخاصة بميزة Attention. القيمة الافتراضية false.
• notifications - عند تفعيل Attention، يسمح لـ TUI بإرسال desktop notifications عبر terminal. القيمة الافتراضية true.
• sound - عند تفعيل Attention، يسمح بتشغيل أصوات التنبيه. القيمة الافتراضية true.
• volume - مستوى صوت التنبيهات الافتراضي من 0 إلى 1. القيمة الافتراضية 0.4.
• sound_pack - sound pack ID المراد استخدامه. القيمة الافتراضية opencode.default.
• sounds - يحدد ملفات صوت مخصصة لـ default أو question أو permission أو error أو done أو subagent_done. يمكن أن تكون المسارات مطلقة، أو file:// URLs، أو نسبية إلى tui.json.

---

التخصيص

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

---

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

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

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