مرجع سطر الأوامر

يعرض elide --help الأوامر اليومية، ويضيف elide --help-all مجموعة Advanced وكل الخيارات. ويطبع elide help <command> قسم الأمر في هذه الصفحة.

التشغيل والتطوير

`run`

يشغّل ملفًا أو سكربتًا مسمّى أو نقطة الدخول للمشروع. ترتيب الاختيار: إعداد المشروع.

elide run app.ts -- --port 3000

الخيار	الوظيفة
`-s, --snippet CODE`	تشغيل مقتطف شيفرة بدلًا من ملف.
`-l, --language LANG`	لغة المقتطف: `js` (الافتراضي) أو `ts` أو `python` أو `java` أو `kotlin`.
`--contexts=<N\|auto>`	عدد سياقات التطبيق المُنشأة مسبقًا؛ تحسب `auto` العدد من الأنوية الفعلية. الافتراضي `1`.

مقتطفات Java و Kotlin برامج كاملة فيها main، وتصل إليها الوسائط الواردة بعد --:

elide run -l java -s 'void main() { System.out.println("hello from java " + (6 * 7)); }'
elide run -l kotlin -s 'fun main(args: Array<String>) = println(args.joinToString())' -- a b

hello from java 42
a, b

يفشل مقتطف Java الخالي من صنف أو من main بالرسالة Could not find a top-level class/record/enum or a main in the Java snippet.، ويفشل مقتطف Kotlin الخالي من main بالرسالة Could not find a `main` function in the Kotlin snippet; declare ⁦`fun main() { ... }`⁩.

خيارات المصحّح والمحلّل وتغطية الشيفرة: خيارات التشخيص.

`serve` (اسم بديل `start`)

يقدّم مجلدًا ملفاتٍ ثابتة، أو سكربتًا يصدّر معالج fetch (خادم التطوير).

elide serve ./public
elide serve server.ts -- --verbose

الخيار	الوظيفة
`--host HOST`	مضيف الربط. الافتراضي `127.0.0.1`.
`--port PORT`	منفذ الربط. الافتراضي `8080`.
`--contexts=<N\|auto>`	عدد سياقات التطبيق المُنشأة مسبقًا، كما في `run`.
`--no-tui`	سجل نصي بسيط بدلًا من لوحة المتابعة.
`-- SCRIPT_ARGS`	وسائط السكربت المُقدَّم.

`dev`

مثل serve وبالخيارات نفسها، على المنفذ 3000. عند تقديم مجلد تُعاد تحميل صفحات HTML في المتصفح عند تغيّر الملفات، أما السكربت فلا يُعاد تحميله. يوقف --no-watch المراقبة وإعادة التحميل.

`install`

يثبّت تبعيات المشروع.

الخيار	الوظيفة
`--ecosystems LIST`	المنظومات المراد تثبيتها، مثل `maven,npm`. الافتراضي `maven`.
`--workspace`	تثبيت كل المنظومات التي يصرّح بها المشروع.
`--with CLASSIFIER`	تنزيل `sources` أو `docs` أو `javadoc` أيضًا.
`--slim`	تنزيل الأصناف فقط.
`--fresh`	تنزيل كل التبعيات من جديد مع تحديث المُخرَجات في ذاكرة التخزين المؤقت العامة.
`--direct`	نسخ المُخرَجات إلى المشروع بدلًا من ربطها.

`repl`

يبدأ REPL التفاعلي. ويفعل الشيء نفسه تشغيل elide وحده في الطرفية.

`python`

يشغّل Python كما يفعل python، وتذهب الوسائط الواردة بعد السكربت إلى البرنامج. ثبّته أولًا باستخدام setup.

elide python script.py --flag-for-the-script

الخيار	الوظيفة
`-c CMD`	تشغيل برنامج مُمرَّر سلسلةً نصية.
`-s`	عدم إضافة مجلد site الخاص بالمستخدم إلى `sys.path`.

خيارات المفسّر (-B و -W و -m وغيرها): خيارات Python.

البناء والاختبار

`build`

يبني ما يصرّح به elide.pkl. تسمّي الكلمات المفردة مهامّ (deps و compile و test و clean؛ والنقطتان : في البداية اختيارية). تذهب الوسائط الواردة بعد -- إلى العملية الفرعية.

elide build deps compile

الخيار	الوظيفة
`-i, --inspect`	عرض مهام المشروع.
`--workers=<N>`	تشغيل N مهمة على الأكثر في الوقت نفسه.
`--no-cache`	تعطيل ذاكرة البناء المؤقتة لهذا التشغيل.
`--offline`	عدم جلب الموارد البعيدة.
`-f, --flag NAME[=VALUE]`	ضبط خيار بناء من ملف البيان (خيارات البناء).

`test`

يشغّل الاختبارات، أو تلك الموجودة تحت المسارات المحددة فقط. تأتي اختبارات JVM من مجموعة مصادر للاختبار: src/test/java أو src/test/kotlin اصطلاحًا، أو مجموعة مصرّح بها في elide.pkl (راجع مجموعات المصادر).

الخيار	الوظيفة
`-t, --test-name-pattern REGEX`	تشغيل الاختبارات التي يطابق اسمها التعبير.
`--where CEL`	⁦JS:⁩ تشغيل الاختبارات التي يكون فيها تعبير CEL على `name` و `parents` و `file` صحيحًا.
`--select SELECTOR`	⁦JVM:⁩ تشغيل ما يسمّيه المُحدِّد: `class:` أو `method:` أو `package:`. قابل للتكرار.
`--include-tag EXPR`	⁦JVM:⁩ تشغيل الاختبارات المطابقة لأي تضمين. قابل للتكرار.
`--exclude-tag EXPR`	⁦JVM:⁩ تخطي الاختبارات المطابقة لأي استبعاد. قابل للتكرار.
`--bail[=N]`	التوقف بعد N إخفاقات. الافتراضي `1`.
`--test-timeout MS`	مهلة كل اختبار. أما `--timeout` فيحدّ التشغيل كله.
`--only`	تشغيل الاختبارات المعلَّمة بـ `.only` فقط.
`--concurrency N`	عدد الاختبارات المتزامنة (ملفات JS، أصناف JVM). الافتراضي `1`.
`--reporter NAME`	`console` أو `junit` أو `tap`.
`--reporter-outfile DIR`	مجلد مخرجات التقرير.

تصحيح الاختبارات: تصحيح الأخطاء.

`format` (اسم بديل `fmt`)

ينسّق مصادر Java و Kotlin. تأتي المسارات وخيارات المنسّق بعد --: elide format -- src.

الخيار	الوظيفة
`--list-files`	طباعة كل ملف يفشل في الفحص أو يتغيّر.
`--list-diffs[=N]`	طباعة الفروق لكل ملف في وضع الفحص؛ ومع `N` فقط عندما يفشل N ملفًا أو أقل.

يفحص --dry-run (بعد --) دون كتابة، ويخرج بالرمز 1 إذا كان ملف ما سيتغيّر.

`project`

الأمر	الغرض
`elide project info`	عرض بيانات المشروع الوصفية بعد حلّها.
`elide project advice`	عرض إرشادات المشروع لوكلاء البرمجة.
`elide project export`	طباعة المشروع بصيغة JSON أو `pom.xml` أو نموذج IntelliJ.

`publish`

elide publish [PROJECT...] [--to <name>] [--skip-existing] [--dry-run] [--sign | --no-sign] [--no-wait]
              [--allow-http-repositories] [--offline]

يبني ملفات JAR للمشروع ويثبّتها مع POM في مستودع Maven المحلي (~/.m2/repository ما لم يحدّد publishing.maven.localRepository غيره). من جذر مساحة العمل ينشر كل المشاريع. ومن مشروع عضو ينشر ذلك العضو وكل مشاريع مساحة العمل التي يعتمد عليها ملف POM الخاص به، لتُثبَّت الإحداثيات التي يذكرها أيضًا. تُبنى كل المشاريع وتُجهَّز وتُوقَّع قبل نشر أي منها، فلا يُنشر شيء إذا حدث إخفاق في هذه المراحل، لكن إخفاق الرفع قد يُبقي المشاريع التي رُفعت قبله. اضبطه في كتلة publishing في ملف البيان.

تسمية مشاريع من مساحة العمل تنشرها هي فقط، مثلًا التي تغيّرت منذ آخر إصدار فقط: elide publish core util --to central. أي مشروع من مساحة العمل تعتمد عليه هذه المشاريع ولم يُسمَّ يجب أن يكون موجودًا في الهدف بالإصدار الذي يصرّح به ملف البيان الخاص به، وإلا فلا يُنشر شيء. المشاريع التي تتركها تحتفظ بإعداد publishing الخاص بها، فيمكن لتشغيل لاحق نشرها مجددًا.

الخيار	الوظيفة
`--to <name>`	النشر إلى المستودع الذي يحمل هذا الاسم في `publishing.maven.repositories` بدلًا من المستودع المحلي.
`--skip-existing`	استبعاد كل مشروع يوجد إصداره في الهدف مسبقًا، مع ذكرها. إصدار snapshot يُنشر دائمًا. مفيد لإعادة تشغيل إصدار فشل في منتصفه.
`--dry-run`	تجهيز ملفات POM و JAR (وتوقيعها) تحت `.dev/staging/publish/maven` وسردها دون نشر. مع Maven Central يكتب الحزمة ويسردها أيضًا ولا يحتاج إلى رمز Portal، لكنه يوقّع مع ذلك، فيحتاج إلى مفتاح توقيع صالح. مع مشاريع مسمّاة أو مع `--skip-existing` يظل يبحث عن الإصدارات في الهدف، فيسرد ما كان التشغيل الفعلي سينشره؛ ويحتاج ذلك مع Central إلى الرمز.
`--sign`، `--no-sign`	توقيع الملفات باستخدام `gpg` أو عدم توقيعها. يُوقَّع النشر البعيد افتراضيًا عند ضبط `signing`.
`--no-wait`	مع Maven Central، العودة بمجرد رفع النشر بدلًا من انتظار التحقق.
`--allow-http-repositories`	السماح بمستودع عبر `http://` غير المشفّر لغير localhost.
`--offline`	البناء دون جلب الموارد البعيدة.

يكون الإصدار موجودًا في الهدف إذا كان ملف POM الخاص به في المستودع المحلي، أو إذا قدّم المستودع البعيد ملف POM الخاص به، أو إذا أفاد Central Portal بأنه منشور. لا يُحتسب نشر في Central جرى التحقق منه ولم يُطلق بعد. وإذا فشل البحث لأي سبب آخر، كرفض بيانات الاعتماد، يتوقف التشغيل بدلًا من اعتبار الإصدار مفقودًا.

صيغ تصدير المشروع

يطبع elide project export --format=<json|pom|intellij> إلى stdout. الافتراضي json.

الصيغة	المخرجات
`json`	ملف البيان بعد تقييمه. تستخدم مميّزات الأنواع `@type` وأسماء أنواع Pkl.
`pom`	الإحداثيات، والتبعيات حسب النطاق، والمستودعات، ومستويات المُصرّف، وجذور المصادر والموارد.
`intellij`	وحدة لكل مجموعة مصادر، مع جذور المحتوى والتبعيات ومستوى SDK وواجهة Kotlin.

pom

عنصر POM	القيمة
`<artifactId>`	اسم المشروع.
`<groupId>`	اسم جذر مساحة العمل، أو اسم المشروع خارج مساحة العمل.
`<version>`	إصدار ملف البيان، أو `0.0.0`.
`<modules>`	أعضاء جذر مساحة العمل.
`<parent>`	جذر مساحة العمل للعضو.

ملف البيان	نطاق Maven
`packages`, `modules`	`compile`
`compileOnly`, `devPackages`, `processors`	`provided`
`runtimeOnly`	`runtime`
`testPackages`	`test`

تصبح المشاريع الشقيقة تبعيات بالإحداثيات، وتصبح ملفات JAR المحلية بنطاق system. يُحذف exclusions و kotlinPlugins. تستخدم جذور المصادر الإضافية build-helper-maven-plugin.

intellij

تُسمّى الوحدات <project>.<sourceSet>. المسارات نسبية إلى root، وهو جذر مساحة العمل أو المشروع. تُحلّ المكتبات من localRepository (الافتراضي .dev/dependencies/m2)، لذا شغّل elide install أولًا. تستورد إضافة IntelliJ IDEA هذا النموذج.

سلسلة أدوات JVM

يأتي Elide مع JDK 25 و Kotlin. تأتي خيارات Elide قبل --، وتليه وسائط الأداة.

`java`

يشغّل برامج JVM، مثل java.

elide java -- -jar app.jar

`javac`

يصرّف شيفرة Java، مثل javac. راجع مُصرّف Java.

الخيار	الوظيفة
`--jar JAR`	حزم ملف JAR في هذا المسار بعد التصريف.
`--manifest MANIFEST`	ملف البيان لمخرجات `--jar`.
`--max-errors N`	عرض N خطأً مختلفًا على الأكثر؛ تعرض `0` الكل.
`--report-used-deps PATH`	كتابة إدخالات classpath التي تستخدمها المخرجات (strict-deps في Bazel).
`--persistent_worker`	العمل عاملًا دائمًا في Bazel.
`--classpath-cache`	إعادة استخدام حالة classpath بين عمليات التصريف في العامل. للعامل فقط.
`--capabilities`	طباعة قدرات المُصرّف بصيغة JSON.

`kotlinc`

يصرّف شيفرة Kotlin، مثل kotlinc. راجع مُصرّف Kotlin.

الخيار	الوظيفة
`--incremental`	التصريف تزايديًا؛ تُحفظ الحالة في `.dev/artifacts/kotlinc/incremental/`.
`--incremental-cache-dir DIR`	مجلد الحالة التزايدية.
`--plugins LIST`	الإضافات المدمجة: `metro` و `serialization` و `atomicfu` و `power-assert`.
`--metro` / `--no-metro`	فرض تفعيل إضافة حقن التبعيات Metro أو تعطيلها.
`--tests`	تفعيل إضافات الاختبار (power-assert).
`--abi-only`	إخراج ملف JAR للواجهة الثنائية (ABI) فقط إلى `-d`.
`--max-errors N`	عرض N خطأً مختلفًا على الأكثر؛ تعرض `0` الكل.
`--report-used-deps PATH`	كتابة إدخالات classpath التي تستخدمها المخرجات (strict-deps في Bazel).
`--persistent_worker`	العمل عاملًا دائمًا في Bazel.

`jar`

يبني ملفات JAR، مثل jar. راجع تجميع JAR.

الإعداد والأدوات

أوامر elide agent مخصّصة لوكلاء البرمجة وغيرهم من المستدعين غير التفاعليين؛ راجع لوكلاء الذكاء الاصطناعي.

الأمر	الخيارات	الوظيفة
`elide agent help [TOPIC]`	`-l, --lang LANG`	طباعة دليل الوكلاء، أو موضوع من التوثيق، بصيغة Markdown.
`elide agent diagnostics`	`--json`	طباعة الإصدار والمنصة ومجلد تقارير الأعطال وحالة الطرفية.
`elide agent bug`	`--kind bug\|perf\|expectation\|feature`, `--json`	طباعة رابط بلاغ ونص التقرير؛ ويطبع `--json` هيكل `elide.report/1`. لا يرسل شيئًا.
`elide agent perf -- COMMAND`	`--runs N` (`10`), `--warmup N` (`3`), `--baseline COMMAND`, `--against VERSION`, `--json`	قياس زمن أمر محليًا، مع مقارنته اختياريًا ببيئة تشغيل أخرى أو بإصدار مثبّت من Elide.

elide agent perf --runs 5 --warmup 1 -- elide run hi.mjs

elide run hi.mjs (5 runs, 1 warmup)
  wall 83.4 ms ± 20.1  min 57.7  max 107.0
  cpu  user 15.8 ms  sys 33.1 ms
  rss  max 66.8 MiB
For servers, measure with wrk or oha and paste the results

الأمر الوارد بعد -- سطر أوامر كامل، بما في ذلك elide. تفاصيل حقول التقرير وخياراته: الإبلاغ عن مشكلة.

`init`

ينشئ مشروعًا من قالب. بدون خيارات يفتح محررًا.

القوالب: java و ktjvm و web-demo و web-simple و workspace (مكتبة Kotlin مع تطبيق).

الخيار	الوظيفة
`--templates`	سرد معرّفات القوالب.
`-t, --template TEMPLATE`	اختيار قالب.
`--parameters`	سرد معاملات القالب.
`--json`	طباعة `--templates` أو `--parameters` بصيغة JSON.
`-i, --plain`	طرح أسئلة نصية بسيطة بدلًا من فتح المحرر.
`-d, --skip-defaults`	تخطي المعاملات التي لها قيم افتراضية. يتطلب `--plain`.
`-s, --skip-run`	عدم تشغيل Elide بعد التوليد.
`--overwrite`	استبدال الملفات الموجودة.

`adopt`

ينقل المشروع الموجود في المجلد الحالي إلى Elide بمساعدة وكيل برمجة بالذكاء الاصطناعي (اعتماد مشروع قائم). بدون خيارات يسأل عن كل اختيار. يخرج بالرمز 0 عند نجاح الوكيل، و 1 عند إخفاقها أو تعذّر بدئها، و 130 عند الضغط على Ctrl+C.

الخيار	الوظيفة
`--build STRATEGY`	`elide` (إنشاء بناء Elide) أو `existing` (الإبقاء على ⁦Maven/Gradle).⁩
`--harness HARNESS`	`codex` أو `claude` أو `omp`.
`--approval MODE`	`auto-approve` أو `manual-approve` أو `yolo` (يتجاوز الحمايات).
`--log`	بث مخرجات الوكيل إلى جانب تسجيلها.
`--prompt-append FILE`	إلحاق إرشادات بالموجّه. قابل للتكرار.
`--non-interactive`	الوضع الدفعي. يتطلب الاختيارات الثلاثة كلها؛ ولا يقبل `manual-approve`.

`help`

اقرأ هذا التوثيق دون اتصال. يطبع اسم الأمر قسمه، ويطبع المعرّف (slug) أو العنوان الصفحة، ويسرد options كل الخيارات.

Get Started › Packages & Installers 0%

──────────────────────────────────────────────────────────────────────────────────

\# Packages & Installers ┃

┃

Upgrade these installs through their package manager, not elide upgrade. Only ┃

Homebrew includes Python; see Installation. ✦ ┃

✧ │

Homebrew │

──────────────────────────────────────────────────────────────────────────────── │

│

bash │

brew install elide-dev/elide/elide │

brew upgrade elide │

│

The [elide-dev/homebrew-elide](https://github.com/elide-dev/homebrew-elide) tap │

tracks nightly on macOS (Apple Silicon) and Linux (amd64, arm64). ✧ │

│

Debian and Ubuntu (apt) │

✦ · │

bash │

↑↓ scroll ⇞⇟ page ⇥ snow esc topics q quit

0:07 / 0:07

الخيار	الوظيفة
`--format FORMAT`	`auto` (الافتراضي) أو `interactive` أو `markdown`.
`-w, --width WIDTH`	أقصى عرض. الافتراضي `110`.
`-l, --lang LANG`	لغة العرض.
`--languages`	سرد لغات العرض.
`--no-animation`	إخفاء حركة الثلج؛ ومفتاح Tab يبدّلها.

`info`

يعرض تفاصيل الملف التنفيذي والمنصة واللغات ونقل الشبكة. ويطبع --cargo-lockfile ملف القفل المضمّن.

`upgrade`

يحدّث Elide.

الخيار	الوظيفة
`--check`	الإبلاغ دون تطبيق.
`--force`	التحديث حتى لو كان الإصدار حديثًا.
`--channel CHANNEL`	`release` أو `nightly`. الافتراضي: قناة هذه النسخة.

`setup`

يثبّت مكوّنًا اختياريًا: elide setup python.

الخيار	الوظيفة
`--channel CHANNEL`	`release` أو `nightly`. الافتراضي: قناة هذه النسخة.
`--force`	إعادة تطبيق مكوّن مثبّت.

يثبّت setup المكوّن للإصدار قيد التشغيل، ولا يرقّي Elide ولا يخفّض إصداره أبدًا. ويحتفظ elide upgrade بالمكوّنات المثبّتة. يرفض setup العمل مع التثبيت عبر مديري الحزم (Homebrew و apt و RPM و MSI و nix و snap)؛ استخدم سكربت التثبيت:

curl -sSL --tlsv1.2 elide.sh | bash -s -- --with-python

`use`

يحدّد إصدارًا في .elideversion وينزّله: elide use 1.6.0.

الخيار	الوظيفة
`--channel CHANNEL`	`release` أو `nightly`.
`--no-install`	كتابة الإصدار المحدد دون تنزيل.

الإصدارات إما إصدارات رسمية (1.6.0، v1.6.0) أو طوابع تاريخ لنسخ nightly (20260921). ويشغّل --ignore-version هذا الملف التنفيذي رغم ذلك.

`lsp`

يبدأ خادم Language Server Protocol عبر stdio. يخدم Java؛ راجع محررات أخرى.

`mcp`

يبدأ خادم Model Context Protocol. راجع خادم MCP للمشروع.

الخيار	الوظيفة
`--mode MODE`	`stdio` (الافتراضي) أو `http` (HTTP+SSE القديم).
`--host HOST`	مضيف ربط HTTP. الافتراضي `localhost`.
`--port PORT`	منفذ ربط HTTP. الافتراضي `8125`.

أوامر متقدمة

يسردها elide --help-all.

`classpath`

يطبع classpath بعد حلّه لـ [<sourceSet>:]<usage>، مثل test:runtime. الاستخدامات: toolchain و processor و compile و modules و runtime و provided. الافتراضي main:compile؛ ويخرج استخدام غير معروف بالرمز 2.

الخيار	الوظيفة
`--offline`	عدم جلب الموارد البعيدة.

`index`

يفهرس تبعيات Maven المحلولة للمشروع ويستعلم من ذلك الفهرس. الإجراءات: build و status (الافتراضي) و get <address> و references <address> و used-by <name> و resolve <name>. العنوان هو maven:group:artifact:version، ويمكن أن يليه /symbol و #member؛ والعضو هو ⁦name(paramType,...)⁩ للدوال والمُنشئات (<init>)، والاسم وحده للحقول. يكتب build الطبقات التي يحددها --layers (الافتراضي l0,l1؛ تضيف l2 تواقيع الأعضاء، وتضيف l3 المراجع الصادرة) بجانب ما بُني منها سابقًا. تخرج get و references و resolve بالرمز 1 عند مُخرَج أو رمز أو عضو أو اسم غير معروف، وبالرمز 2 عندما لم تُبنَ بعد طبقة تحتاجها؛ شغّل ⁦elide index build --layers=...⁩.

يصرّف build أيضًا مصادر Java و Kotlin الرئيسية ويحدّث فهرس مراجعها المحلي. يقرأ references local:<project>/<type> المراجع الصادرة لصنف محلي؛ ويطبع used-by <type>[#member] ملفات المصدر المحلية المطابقة بمسارات نسبية إلى الحزمة. لا تحدّث الاستعلامات تلك المراجع المصرَّفة. للأمثلة وحدود النطاق التجريبي راجع فهرس شيفرة التبعيات.

الخيار	الوظيفة
`--layers=<l0,l1,l2,l3>`	الطبقات التي يكتبها `build`؛ تُضمَّن `l0` دائمًا.
`--offline`	عدم جلب الموارد البعيدة.

`javadoc`

يولّد Javadoc، مثل javadoc. تأتي الوسائط بعد --.

الخيار	الوظيفة
`--theme THEME`	`default` أو `elide`.

`javaformat`

ينسّق شيفرة Java باستخدام google-java-format، أو بلهجة Netflix jfmt مع --jfmt. تأتي الوسائط بعد --. يقبل --list-files و --list-diffs من format. راجع التنسيق.

`javap`

يفكّك شيفرة JVM الثنائية (bytecode)، مثل javap. تأتي الوسائط بعد --.

`jdeps`

يحلّل تبعيات أصناف JVM، مثل jdeps. تأتي الوسائط بعد --.

`ktfmt`

ينسّق شيفرة Kotlin باستخدام ktfmt. تأتي الوسائط بعد --. يقبل --list-files و --list-diffs من format.

`mvn`

يشغّل Maven، مثل mvn: elide mvn -- package. راجع Native Maven.

الخيار (بعد `--`)	الوظيفة
`--flavor NAME`	مجموعة الإضافات، مثل `spring@4.1.0`. تُكتشف من `pom.xml` افتراضيًا.
`--mode=MODE`	`native` (الافتراضي) أو `mixed` أو `legacy`.
`--yes`	الموافقة على التنزيلات دون سؤال.
`--porcelain`	بث مخرجات Maven الأصلية.

`native-image`

يبني برنامج JVM ملفًا تنفيذيًا أصليًا. تأتي الوسائط بعد --. راجع Native Image.

`rewrite`

يشغّل وصفات OpenRewrite على مصادر Java الرئيسية للمشروع (تجريبي في 1.6.0). تأتي الوصفات من المكتبات المضمّنة ومن dependencies.maven.devPackages، وتأتي أنواع التبعيات من فهرس الشيفرة. يطبع elide rewrite --list الوصفات المتاحة، ويطبّقها elide rewrite <name>… بالترتيب. يصرّف سير العمل الافتراضي المصادر الرئيسية ويصفّي الملفات المرشّحة حين تدعم ذلك الشروط المسبقة للوصفات. للإعداد والأمثلة وحدود التوافق راجع OpenRewrite. يخرج بالرمز 1 عند وصفة غير معروفة، و 2 عند خطأ في الاستخدام.

الخيار	الوظيفة
`--dry-run`	طباعة الفروق دون تطبيق تغييرات المصادر؛ وقد تُكتب حالة البناء مع ذلك.
`--list`	سرد الوصفات المتاحة دون تصريف المصادر الرئيسية.
`--no-prefilter`	تخطي تصريف المصادر الرئيسية وتحليل كل مصادر Java الرئيسية.
`--offline`	عدم جلب الموارد البعيدة.

`web`

أدوات الويب: يبني elide web build app.ts page.md --out dist الملفات دون ملف بيان. راجع سلسلة أدوات الويب.

الخيار	الوظيفة
`-o, --out DIR`	مجلد المخرجات.

الخيارات العامة

تُقبل قبل اسم الأمر أو بعده، وقبل أي --.

الخيارات الشائعة

الخيار	الوظيفة
`-p, --project PATH`	مجلد المشروع.
`-f, --flag NAME[=VALUE]`	ضبط خيار بناء من ملف البيان.
`-q, --quiet`	إخفاء مؤشرات التقدم. تظل التحذيرات والأخطاء ومخرجات البرنامج تُطبع.
`-v, --verbose` / `--debug`	سجلات أكثر.
`--color` / `--no-color`	فرض تفعيل الألوان أو تعطيلها.
`--timeout DURATION`	حد زمني، مثل `30s` أو `5m`؛ تعطّله `0`. ينهي العمليات الفرعية ويخرج بالرمز `124`.
`--max-mem SIZE`	حد الكومة، مثل `512m` أو `8g`. الافتراضي `4g` للتشغيل لمرة واحدة.
`--limit NAME=COUNT`	حد مورد: `workers` أو `fds`. قابل للتكرار.
`--interop`	مشاركة سياق واحد بين اللغات (اللغات والتشغيل البيني).
`-V, --version`	طباعة الإصدار.

خيارات العزل

تعمل البرامج دون قيود حتى تمرّر خيار عزل. راجع العزل والحدود.

الخيار	الوظيفة
`--sandbox[=PROFILE]`	ملف التعريف: `trusted`. يقيّد `--sandbox` وحده الوصول إلى نظام الملفات.
`--allow-read[=PATHS]`	منح القراءة؛ وبدون قيمة يمنح الكل.
`--allow-write[=PATHS]`	منح الكتابة؛ وبدون قيمة يمنح الكل.
`--allow-net[=HOSTS]`	السماح بالشبكة؛ وبدون قيمة يسمح بالكل.
`--deny-net=HOSTS`	منع مضيفين؛ ويتقدّم على `--allow-net`.
`--allow-run[=CMDS]`	السماح بالعمليات الفرعية؛ وبدون قيمة يسمح بالكل.
`--deny-run=CMDS`	منع أوامر؛ ويتقدّم على `--allow-run`.
`--allow-env[=NAMES]`	المتغيرات التي يمكن لملف البيان قراءتها؛ وبدون قيمة يسمح بالكل.
`--fs-audit`	تسجيل كل قرار وصول إلى نظام الملفات.
`--allow-threads`	السماح بخيوط الضيف. ممنوعة افتراضيًا.
`--allow-native` / `--no-native`	السماح بالوصول الأصلي للضيف أو منعه.

خيارات التشخيص

الخيار	الوظيفة
`--debugger[=MODE\|ADDRESS]`	ربط مصحّح: `auto` أو `cdp` أو `dap` أو عنوان JDWP (`5005`، `host:5005`). راجع تصحيح الأخطاء.
`--debugger-host HOST`	مضيف ربط المصحّح. الافتراضي `127.0.0.1`.
`--debugger-port PORT`	منفذ المصحّح. الافتراضي `4711` (DAP) أو `1337` (CDP).
`--profiler[=PROFILER]`	`cputracing` أو `cpusampling` أو `memtracing`.
`--coverage[=auto]`	جمع تغطية الشيفرة.
`--insights INSIGHTS`	حقن سكربتات Insight.
`--error-format FORMAT`	الأخطاء غير الملتقطة: `auto` (الافتراضي) أو `pretty` أو `plain`.
`--abort-on-uncaught-exception`	الإجهاض بـ `SIGABRT` عند استثناء غير ملتقط.
`--redirect-warnings FILE`	كتابة التحذيرات إلى FILE بدلًا من stderr.

خيارات الإصدار

الخيار	الوظيفة
`--use-version VERSION`	تشغيل إصدار آخر مثبّت من Elide.
`--ignore-version`	تجاهل `.elideversion` و `--use-version`.

خيارات متقدمة

الخيار	الوظيفة
`--transport TRANSPORT`	نقل الشبكة (نقل الشبكة).
`--locale LOCALE`	لغة سطر الأوامر، مثل `fr`.
`-X, --vm KEY=VALUE`	ضبط خاصية في الآلة الافتراضية.
`--safe-close`	إيقاف كامل حتى في التشغيل لمرة واحدة.
`--pkgst` / `--no-pkgst`	مقبول؛ بلا أثر. لتجاوز الوكيل `maven.pkg.st` راجع المستودعات.
`--otel-endpoint=URL`	إرسال بيانات OpenTelemetry إلى نقطة نهاية OTLP هذه.
`--otel-provider=PROVIDER`	إرسال بيانات OpenTelemetry إلى مزوّد: `otlp` أو `sentry` أو `datadog` أو `posthog` أو `honeycomb` أو `grafana`.
`--otel-protocol=PROTOCOL`	بروتوكول ⁦OTLP:⁩ `grpc` أو `http/protobuf` أو `http/json`.
`--otel-shutdown=MODE`	طريقة إرسال التصدير الأخير عند الخروج: `sidecar` أو `inline` أو `drop`.
`--no-otel`	إيقاف تصدير OpenTelemetry.
`--help-instruments`	سرد خيارات أدوات القياس.

خيارات Python

خيارات CPython؛ ضعها قبل السكربت.

الخيار	الوظيفة
`-I`	الوضع المعزول.
`-B`	عدم كتابة ملفات الشيفرة الثنائية.
`-E`	تجاهل متغيرات البيئة `PYTHON*`.
`-S`	عدم تنفيذ `import site` عند البدء.
`-u`	عدم تخزين stdout و stderr مؤقتًا.
`-P`	عدم إضافة مسار غير آمن إلى بداية `sys.path`.
`-O`	التحسين. قابل للتكرار.
`-b`	التحذير من مقارنات ⁦bytes/str.⁩ قابل للتكرار.
`-x`	مقبول؛ بلا أثر.
`-W ARG`	التحكم في التحذيرات. قابل للتكرار.
`-m MODULE`	تشغيل وحدة على أنها `__main__`.

نقل الشبكة

`--transport=`	الوظيفة
`auto`	الافتراضي: `v2` على Linux و macOS، و `nio` على غيرهما.
`v2`	نقل Elide الأصلي.
`epoll`, `kqueue`, `io_uring`	`v2` مع برنامج التشغيل هذا. يفشل على المنصات الأخرى.
`nio`	نقل محمول يعمل على كل المنصات.

أدوات القياس

الخيار	الوظيفة
`--jfr FILE`	تسجيل ملف JFR يُحفظ عند الخروج.
`--jfr-settings SETTINGS`	`default` أو `profile` (الافتراضي) أو ملف `.jfc`.
`--jitdump DIR`	كتابة بيانات JIT الوصفية لأداة `perf` في Linux.
`--heap-dump FILE`	تفريغ الكومة عند الخروج.
`--heap-dump-on-oom FILE`	تفريغ الكومة عند نفاد الذاكرة، ثم الخروج بالرمز `3`.
`--vmstat`	جعل العملية مرئية لـ `jps` و `jstat` و `jcmd`.

رموز الخروج

الرمز	المعنى
`0`	نجاح، أو مخرجات المساعدة أو الإصدار.
`1`	فشل الأمر أو البرنامج.
`2`	استخدام غير صالح، أو هدف تشغيل غير معروف، أو أمر محذوف.
`3`	نفاد الذاكرة؛ وكتب `--heap-dump-on-oom` تفريغًا للكومة.
`124`	انتهت مهلة `--timeout`.
غير ذلك	يحدده البرنامج أو الأداة.

تدفقات الإخراج

تذهب مخرجات البرنامج وتقارير الاختبارات والمخرجات المقروءة آليًا إلى stdout.
تذهب مؤشرات التقدم والتشخيصات إلى stderr.
تُعطَّل الألوان عندما لا يكون التدفق طرفية. تفرض --color أو FORCE_COLOR أو CLICOLOR_FORCE تفعيلها، وتعطّلها --no-color أو NO_COLOR.
يخفي --quiet مؤشرات التقدم فقط.

التشغيل والتطوير

run

serve (اسم بديل start)

dev

install

repl

python

البناء والاختبار

build

test

format (اسم بديل fmt)

project

publish