الدليل
أدوات التطوير
محررات بديلة
يأتي Omarchy مع Neovim افتراضيًا، لكن إذا أردت شيئًا أكثر انتشارًا وألفة، يمكنك تشغيل قائمة Omarchy (Super + Space) ورؤية الخيارات ضمن Install > Editor. ستجد هناك VSCode وCursor وZed وSublime Text وHelix وVim وEmacs مدرجة. وإذا لم تجد ما تبحث عنه، فاطّلع على Install > Package لترى إن كان موجودًا في إحدى حزم Arch (وإن لم يكن، فجرّب Install > AUR للتحقق من AUR).
المحرر الأصلي vi متاح أيضًا من الأساس. شغّل vi filename لتحرير ملف في الطرفية.
تُتاح مطابقة السمات لـ VSCode وCursor وVSCodium وHelix.
يمكنك تعيين المحرر الافتراضي على مستوى النظام ضمن Setup > Defaults > Editor.
البيئة
يدعم Omarchy إعداد مجموعة كبيرة كاملة من بيئات التطوير من خلال قسم Install > Development في قائمة Omarchy (Super + Space). ستجد بالطبع Ruby on Rails، وأيضًا بيئات التشغيل الرئيسية الثلاث كلها لـ JavaScript (Node.js وBun وDeno)، بالإضافة إلى أطر PHP الشائعة مثل Laravel وSymfony. آه، وهناك أيضًا Go وRust وPython وJava وElixir (مع Phoenix) و.NET وOCaml وZig وClojure وScala. إنها مجموعة واسعة جدًا!
تُدار غالبية هذه البيئات بواسطة Mise. إنها أداة تتيح لك تثبيت إصدارات متعددة من لغة برمجة وتشغيلها على الجهاز نفسه. إنها مثل rbenv أو rvm لـ Ruby أو virtualenv لـ Python، لكنها تعمل مع مجموعة كبيرة من البيئات المختلفة.
لتثبيت Ruby مثلًا، شغّل mise use -g ruby، وسيؤدي ذلك إلى تثبيت Ruby وتعيينه كالافتراضي العام في الوقت نفسه. أو، إذا كان مشروعك يحتوي على ملف .ruby-version، فيمكنك ببساطة تشغيل mise i في جذر ذلك المشروع.
أدوات سطر الأوامر المثبتة مسبقًا
يتيح Omarchy أدوات مثل gh وuv ومعظم وكلاء البرمجة من خلال التثبيت الكسول في mise. في أول مرة تشغّل فيها إحداها، يثبّتها mise. وتعيد عمليات التشغيل اللاحقة استخدام الإصدار المثبت؛ فهي لا تتحقق من وجود تحديث في كل تشغيل.
يمكنك أيضًا فحص الإعدادات الافتراضية أو تثبيتها مسبقًا:
mise ls --current # List the tools configured for this directory
mise install gh # Install one tool now
mise install --include-lazy # Install all configured tools, including lazy tools
شغّل omarchy update لتحديث الأدوات المثبتة مع بقية Omarchy. ويحدّث الاسم المستعار mup الأدوات التي يديرها mise فقط. لإضافة أداة أخرى إلى إعداداتك الخاصة، استخدم mise use -g <tool>.
يُثبّت إعداد Python أيضًا uv من خلال mise. وتترك إزالة بيئة تطوير Python أداة uv متاحة كأداة مستقلة.
استخدام التثبيت الخاص بك
تأتي أوامر mise قبل ~/.local/bin في PATH، لذا فإن الأداة التي ثبّتها بنفسك، على سبيل المثال باستخدام مثبّت Claude Code أو Cursor الخاص، ستظل تشغّل نسخة mise. كما تجد التطبيقات التي تُشغَّل من سطح المكتب أوامر mise قبل حزم النظام، لذا فإن التطبيق الذي يشغّل gh يحصل على نسخة mise حتى لو ثبّت github-cli باستخدام pacman، ويثبّت mise تلك النسخة في أول مرة. لاستخدام نسختك بدلًا من ذلك، عطّل نسخة mise في ~/.config/mise/config.toml. على سبيل المثال، إذا ثبّت Cursor CLI بنفسك:
[settings]
disable_tools = ["cursor-agent"]
إذا كان لديك جدول [settings] بالفعل، فأضف الإدخال هناك؛ ووسّع قائمة disable_tools موجودة بدلًا من استبدالها. تأكد من أن التثبيت الخاص بك موجود في PATH. استخدم اسم أداة mise، الذي قد يختلف عن أمرها: فأداة oh-my-pi توفّر omp، على سبيل المثال. كما يفضّل مشغّل الوكيل الافتراضي أيضًا Cursor أو Muse المثبّت من قبل المستخدم في ~/.local/bin.
إزالة الإعدادات الافتراضية واستعادتها
يجعل خيار Remove Preinstalls أداة mise تتخطى إعلانات أدوات Omarchy الخاصة بمستخدمك، وذلك بإضافتها إلى ignored_config_paths في ~/.config/mise/miserc.toml. ويزيل خيار Restore Preinstalls ذلك السطر مرة أخرى. وتظل الأدوات التي تعلنها بنفسك، في إعداداتك الخاصة أو في ملف mise.toml الخاص بمشروع، تعمل في كلتا الحالتين. وإذا اخترت وكيلًا افتراضيًا أو أعددت Python بعد إزالة التثبيتات المسبقة، فستُضاف تلك الأداة إلى إعداداتك الخاصة. وينطبق كلا الخيارين على مستخدمك فقط؛ ويحتفظ المستخدمون الآخرون على الجهاز بخيارهم الخاص.
Docker
يكاد Docker لا يحتاج إلى أي تعريف. فهو يتيح لك تشغيل حاويات معزولة، ويثبّت Omarchy كل ما يلزم لتشغيله بشكل جيد، بما في ذلك Docker نفسه وDocker Compose.
افتراضيًا، مستخدمك ليس في مجموعة docker. فتلك المجموعة تعادل فعليًا صلاحيات root من دون كلمة مرور - يمكن لأي شيء فيها تشغيل docker run -v /:/host والسيطرة على الجهاز - لذا فإن نصًا برمجيًا مارقًا واحدًا أو تبعية واحدة تعمل باسمك ستكون بخلاف ذلك على بُعد أمر واحد من root. لذلك، في سطر الأوامر، تشغّل Docker باستخدام sudo (sudo docker ps وsudo docker compose up)، وتطلب الأدوات الرسومية التي تتحدث إلى الخدمة - آلة Windows الافتراضية VM - الإذن عندما تحتاج إليه. وإذا أردت استعادة راحة الإعداد من دون مجموعة وفهمت المقايضة، ففعّلها من Setup > Security > Sudoless Docker (أو شغّل omarchy-setup-security-sudoless-docker)، وهو ما يضيفك إلى مجموعة docker بعد تحذير؛ وبعد ذلك يعمل docker العادي والاسم المستعار d من دون sudo مرة أخرى.
يمكنك إعداد قواعد البيانات الشائعة للتطوير المحلي في Docker باستخدام Install > Development > Docker DB في قائمة Omarchy.
GitHub CLI
GitHub CLI متاح باسم gh للعمل مع المستودعات والقضايا وطلبات السحب من الطرفية. شغّل gh auth login لتثبيته عند أول استخدام والمصادقة، ثم gh repo clone org/repo لاستنساخ مستودع. شغّل gh --help لاستكشاف أوامره.
للحصول على واجهة طرفية لطلبات السحب، شغّل ghui؛ ويثبّته mise أيضًا عند أول استخدام. وLazygit مثبّت مسبقًا للعمل مع Git نفسه.