---
title: "مرجع CLI | وثائق Kilobat"
url: "https://kilobat.app/ar/docs/cli"
description: "كل أوامر kilobat، ومخرجات JSON، والبرمجة النصية."
---

# مرجع CLI

كل أوامر kilobat، ومخرجات JSON، والبرمجة النصية.

## الأوامر

### المراقبة

|  |  |
|---|---|
| `kilobat status [--watch] [--json]` | حركة مباشرة لكل تطبيق وحد بيانات الجلسة؛ لقطة JSON أو تدفق أسطر JSON مع --watch |
| `kilobat report [--csv\|--json] [--summary] [--days 1…365]` | سجل الاستخدام المسجل محليًا، أو الإجماليات اليومية وأكثر التطبيقات استخدامًا؛ يحتوي CSV على صف لكل تطبيق |
| `kilobat report compare --total 40GB [--unit GB\|GiB] [--direction both\|download\|upload] (--from DATE --to DATE \| --period last-month) [--network NAME] [--json\|--csv]` | رقم الموجّه أو المزوّد بجوار ما سجله Kilobat على Mac هذا للفترة نفسها وبالوحدة نفسها، مع ساعات التسجيل وكل فجوة والأسباب المحتملة للاختلاف |
| `kilobat health-history [--hours 1…720] [--json]` | فحوص الموجّه والإنترنت والتذبذب وDNS التي سجلها التطبيق بمرور الوقت |
| `kilobat proxy [routes [--app name] \| test] [--json]` | تطبيقات الوكيل ووكيل النظام ومشكلاتها؛ والقاعدة والعقدة اللتان استخدمهما كل تطبيق؛ وسرعة استجابة كل عقدة |
| `kilobat vpn [--json]` | VPN وما إذا كان DNS أو IPv6 يتجاوزانه، وحالة مفتاح إيقاف VPN |
| `kilobat vpn leaks [--json]` | اختبار التسريب: ما إذا كان DNS أو IPv6 أو UDP (الذي يستخدمه WebRTC) يتجاوز VPN، مع الإعداد الذي يصلح كلًا منها؛ يستعلم من bash.ws وCloudflare وخادم STUN |
| `kilobat calls [--limit 1…200] [--json]` | بعد كل مكالمة: عدد مرات تجمدها وسببها، من التقارير التي يكتبها التطبيق |
| `kilobat remote [--limit 1…200] [--kind ssh\|mosh\|desktop] [--json]` | بعد كل جلسة SSH أو Mosh أو سطح مكتب بعيد: سبب تأخر الكتابة أو تجمد الشاشة، ومتى يفيد Mosh |
| `kilobat stream [status\|check\|reports] [--json]` | OBS عبر WebSocket المحلي الخاص به: ما إذا كان يبث مباشرةً ويفقد إطارات، وفحص سرعة الرفع قبل البث مقارنةً بمعدل البت للبث مضافًا إليه 30% (check [--bitrate <kbps>] [--measure\|--no-measure])، والتقارير بعد كل بث (reports [--limit 1…200]) |
| `kilobat cloud-gaming [status\|reports] [--limit 1…200] [--json]` | GeForce NOW وXbox Cloud Gaming وBoosteroid وAmazon Luna وShadow: الجلسة الحالية (ping وتفاوت التأخير والفقد ومعدل البت والبيانات والعوائق) والتقرير بعد كل جلسة، مع وقت التقطّع وسببه |
| `kilobat overlay [--port 7171] [--target internet\|router\|cs2:fra\|host]` | عرض متراكب مباشر لزمن الاستجابة لـ OBS وتطبيقات البث الأخرى، يُقدّم على localhost حتى Ctrl-C؛ تقيس منطقة لعبة مثل cs2:fra زمن الاستجابة لمركز البيانات هذا |
| `kilobat support-report [--hours 1…168] [--host h] [--include-sites] [--markdown\|--html] [--output f]` | تقرير لمزوّد الخدمة أو قسم تقنية المعلومات: النتائج وزمن الاستجابة والانقطاعات واختبارات السرعة، دون اسم شبكتك أو العناوين المحلية |
| `kilobat plan [--days 7…90] [--json]` | اختبارات السرعة مقارنة بالباقة المدفوعة على كل شبكة: الوسيط والمساء بجوار بقية اليوم وعدد الاختبارات التي حققت أقل من النصف |
| `kilobat credit [--provider id] [--price n] [--month this\|last\|YYYY-MM] [--draft] [--json]` | انقطاعات الشهر خارج الموجّه مقارنة بقاعدة التعويض المنشورة لدى المزوّد وما قد تستحقه ومسودة مطالبة؛ يسرد <code>credit providers</code> القواعد |
| `kilobat week [--weeks-ago 0…12] [--json]` | الملخص الأسبوعي: أبرز انقطاعات الأسبوع الماضي والمكالمات المتجمدة والموجّه وعمليات الحظر والبيانات المحدودة، مقارنة بالأسبوع السابق |
| `kilobat router [--all] [--json]` | فحص الموجّه: استجاباته المعتادة والفقد والانقطاعات مقارنة بالأيام الثلاثة الأخيرة، وإعادة التشغيل وما إذا ساعدت، من الفحوص التي يحتفظ بها التطبيق |
| `kilobat router connect [fritzbox\|unifi\|mikrotik\|openwrt] [--json]` | خطوات إعداد اتصال الموجّه في التطبيق مع Pro؛ لا يأخذ بيانات الاعتماد عبر سطر الأوامر مطلقًا |
| `kilobat router devices [--json]` | عملاء الموجّه المتصل ومعدلاتهم المقيسة وإجماليات اليوم عبر التطبيق؛ لا تعني عدادات FRITZ!Box أو غيرها للمنزل كله حصة جهاز واحد، وقد تشمل عدادات العملاء حركة LAN |
| `kilobat router disconnect [--json]` | نسيان الموجّه لهذه الشبكة؛ يزيل التطبيق بيانات اعتماده من سلسلة المفاتيح، أو يزيلها عند تشغيله التالي |
| `kilobat service-speed [--all] [--test <service>] [--list] [--json]` | تنزيلاتك من GitHub وiCloud وSteam وnpm وغيرها مقارنةً باتصالك، ومتى يكون مسار مزوّد الخدمة إلى إحداها بطيئًا؛ ينزّل <code>--test</code> الآن حتى 25 MB من إحداها |
| `kilobat hotspot [--all] [--carrier <id>] [--detect] [--json]` | على نقطة اتصال هاتف: ما إذا كانت كل التنزيلات تتوقف عند حد نقطة اتصال شركة الاتصالات، والقياسات التي يستند إليها ذلك وقواعد الشركة المنشورة؛ يسردها <code>hotspot carriers</code> |
| `kilobat networks [forget <name>]` | الشبكات التي شوهدت مع الملف الشخصي وحد البيانات وتكلفة البيانات المحفوظة لكل منها |
| `kilobat networks cost <metered\|unmetered\|automatic> [name]` | عامل هذه الشبكة أو شبكة مسماة كمحدودة أو غير محدودة البيانات، أو اتبع macOS مجددًا |
| `kilobat bandwidth [app] [hour\|day\|week\|month] [--back N] [--json]` | بايتات تطبيق واحد المرسلة والمستقبلة خلال ساعة أو يوم أو أسبوع أو شهر، مع الذروة؛ ينتقل --back إلى فترات سابقة |
| `kilobat access-policy <bundle-id> [--json]` | الاتصالات التي يعلنها مطوّر التطبيق في سياسة الوصول إلى الإنترنت وسببها |

### التشخيص

|  |  |
|---|---|
| `kilobat diagnose [--json]` | فحوص Wi-Fi والموجّه والإنترنت وDNS وبوابة تسجيل الدخول مع نصائح |
| `kilobat radar [--watch] [--json]` | درجة الإشارة والبحث عن أفضل موضع |
| `kilobat scan [--json]` | الشبكات والقنوات والعروض ومستويات الأمان القريبة |
| `kilobat channels [--json]` | الازدحام لكل قناة وأقلها ازدحامًا |
| `kilobat speedtest [--json] [--budget-mb 1…80] [--parallel]` | سرعة Cloudflare وزمن الاستجابة تحت الحمل وتقييم المكالمات والبث، بحد أقصى 80 MB. اتصال واحد افتراضيًا؛ يفتح --parallel أربعة اتصالات كما تفعل معظم مواقع اختبار السرعة |
| `kilobat speed-compare [<test> <test>] [--json]` | ما اختلف بين اختباري سرعة محفوظين: الشبكة والوقت والخادم والاتصالات ونطاق Wi-Fi والإشارة وVPN وحركة البيانات الأخرى |
| `kilobat ip [--public] [--json]` | مكان خروج حركة البيانات: الواجهة وأي VPN، مقروءة على Mac هذا؛ يطلب --public أيضًا عنوان IP العام وبلد تسجيله من Cloudflare |
| `kilobat portal [open] [--json]` | صفحات تسجيل دخول Wi-Fi: فحص الآن (مفتوحة أو صفحة تسجيل دخول أو غير متصلة، مع عنوان الصفحة وحجب قيم الاستعلام)، وما إذا كانت الشبكة تطلب تسجيل الدخول أو سجلت خروجك أو المدة المتبقية، ومدة الدخول المعتادة لكل شبكة؛ يفتح open الصفحة في المتصفح |
| `kilobat stutter [--seconds 10…60] [--target router\|internet\|<host>] [--json]` | قياس الاستجابة كل 50 ms لإيجاد ارتفاعات زمن الاستجابة القصيرة التي تفوت اختبارات السرعة، ومتى تحدث وما إذا كانت تتكرر |
| `kilobat starlink [--hours 1…720] [--json]` | طبق Starlink على هذه الشبكة، يُقرأ محليًا منه: الحالة وزمن استجابة المحطة الأرضية والتنبيهات وخريطة السماء واتجاه احتجابها والانقطاعات مقسمة إلى إعدادك وشبكة Starlink وإعادة تشغيل الطبق |
| `kilobat games [--game <game> \| --all \| --match] [--json]` | يسرد الألعاب التي يقيس Kilobat زمن استجابتها والتي لا يستطيع قياسها والسبب؛ ومع --game يقيس كل مركز بيانات للعبة (مرحّلات Valve أو خوادم قياس Epic أو مناطق AWS وAzure التي تستضيفها) خمس مرات ويحدد الأقرب إليك؛ ومع --match يجد خادم المباراة التي تلعبها ويقيسه لأي لعبة، جاهزًا للعرض المتراكب للبث. |
| `kilobat airdrop [status\|everyone\|contacts\|off] [--json]` | إمكانية ظهور AirDrop ورابط AirDrop (AWDL) وما يستخدمه؛ يؤدي تغيير الظهور إلى فتح إعدادات النظام |
| `kilobat bluetooth [--json]` | أجهزة Bluetooth وما إذا كانت تشارك Wi-Fi تردد 2.4 GHz |
| `kilobat bluetooth audio [--json]` | أثناء تشغيل AirPods أو سماعات Bluetooth أخرى: ما قد يسبب التشويش (2.4 GHz أو AirDrop أو تنزيل كبير أو إشارة ضعيفة) وما يجب تغييره بالترتيب |
| `kilobat local [check] [--quick] [--json]` | هل يمكنني البث أو الطباعة هنا؟ أجهزة Chromecast ومستقبلات AirPlay والطابعات التي تستجيب، وما إذا كانت الشبكة قد تعزل الأجهزة عن بعضها (لا يؤكده الاكتشاف وحده أبدًا)، وشبكة Wi-Fi الخاصة بالطابعة أو الكاميرا، وما يسبب تقطّع البث |
| `kilobat dns [automatic\|cloudflare\|google\|quad9\|flush]` | قراءة DNS أو تعيينه أو مسح ذاكرة التخزين المؤقت |
| `kilobat dns fastest [--all] [--json]` | أسرع DNS على هذه الشبكة، من تشغيلات التطبيق الهادئة بمقارنة Cloudflare وQuad9 وGoogle، مع الجهة التي تدير كلًا منها ومكانها، واستعلاماته المجاب عنها خلال 14 يومًا |
| `kilobat dns auto on\|off [--network <name>]` | Pro: الانتقال إلى أسرع DNS عند الاتصال، في كل مكان أو على شبكة واحدة |
| `kilobat dns exclude\|include <resolver>` | عدم قياس أو اختيار محلّل أسماء أبدًا، أو إضافة محلّل خاص بعنوان IP |
| `kilobat dns fallback <resolver>\|off` | محلّل DNS الذي يُنتقل إليه عند فشل الأسرع، قبل الخاص بالشبكة |

### Wi-Fi

|  |  |
|---|---|
| `kilobat wifi [status]` | الشبكة الحالية والإشارة والقناة والعرض ومعدل الاتصال ومعيار Wi-Fi والأمان وقدرة الإرسال |
| `kilobat wifi on\|off\|restart\|disconnect` | التحكم في تشغيل Wi-Fi والاتصال |
| `kilobat wifi join <name> [--password-stdin]` | الانضمام إلى شبكة محفوظة أو جديدة |
| `kilobat wifi known` | الشبكات المحفوظة بترتيب الأفضلية |
| `kilobat wifi password\|share <name>` | إظهار كلمة سر محفوظة أو رمز QR لمسحه بالهاتف |
| `kilobat wifi nodes [name <node> <name>] [--json]` | عُقد الشبكة المتداخلة أو نقاط الوصول لهذه الشبكة، والعقدة المتصل بها الـ Mac، وما إذا كانت عقدة أقرب بكثير ضمن النطاق؛ سمِّ إحداها، مثل «المكتب» |
| `kilobat wifi reconnect [--json]` | انتقل إلى العقدة الأقرب، ثم اذكر أين انتهى موقع الـ Mac |
| `kilobat low-latency on [--for 15m\|1h\|2h] [--until-quit <app>]` | إيقاف AirDrop وAWDL مؤقتًا أثناء المكالمات والألعاب: 15 دقيقة افتراضيًا، وحتى 4 ساعات، أو حتى إنهاء تطبيق |
| `kilobat low-latency off` | استعادة AirDrop وAWDL، بما في ذلك للإيقاف الذي بدأ من التطبيق |

### إبقاء الجهاز مستيقظًا والوكلاء

|  |  |
|---|---|
| `kilobat awake [--display]` | إبقاء Mac مستيقظًا حتى Ctrl-C؛ يظل إغلاق الغطاء يضعه في وضع النوم ما لم تضف --lid-closed |
| `kilobat awake --lid-closed [--for 2h\|--until-quiet\|-- <command>]` | مواصلة التشغيل مع إغلاق الغطاء أيضًا، لمدة 8 ساعات كحد أقصى، عبر مساعد طاقة التطبيق؛ يتطلب السماح بالتشغيل والغطاء مغلق في الإعدادات |
| `kilobat awake --for 90m\|2h\|45s` | البقاء مستيقظًا لمدة معينة |
| `kilobat awake --until-quiet [--app <id>] [--quiet 1…60]` | البقاء مستيقظًا حتى تخمد التنزيلات أو تطبيق واحد، أي أقل من 16 KB/s لمدة 3 دقائق افتراضيًا |
| `kilobat awake -- <command> [args]` | البقاء مستيقظًا أثناء تشغيل أمر، ثم عرض البيانات التي نقلتها عملياته والخروج بحالته |
| `kilobat awake --while-frontmost <app> [--display] [--for 2h]` | البقاء مستيقظًا فقط أثناء ظهور التطبيق في المقدمة، للقراءة أو العرض. يسمح الانتقال إلى تطبيق آخر بنوم Mac؛ وتنتهي الجلسة عند إنهاء التطبيق أو بلوغ البطارية 20% أو انتهاء --for. يبقي --display الشاشة قيد التشغيل أيضًا |
| `kilobat settings awake-on-power on\|off` | يبقى التطبيق مستيقظًا كلما كان محول الطاقة موصولًا ويسمح بنوم Mac مجددًا عند فصله |
| `kilobat settings keep-screen-on on\|off` | إبقاء الشاشة قيد التشغيل أيضًا لكل ما يبقيه التطبيق مستيقظًا: المؤقتات والتنزيلات والوكلاء والتطبيق في المقدمة والطاقة الموصولة |
| `kilobat sessions [--days N] [--json]` | جلسات إبقاء الجهاز مستيقظًا وعمليات وكلاء الذكاء الاصطناعي التي سجلها التطبيق، مع البيانات المستخدمة وتغييرات الشبكة |
| `kilobat agent-log [--all] [--since 2h\|3d\|date] [--agent claude] [--flagged] [--json]` | كل مضيف اتصل به وكيل ذكاء اصطناعي والأوامر التي شغّلها، مع البايتات والعلامات: أحدث جلسة أو جلسة الوكيل نفسه عند التشغيل منه. يسجلها التطبيق مع Pro |
| `kilobat history forget <host> [--subdomains] [--json]` | إزالة مضيف من المحاولات المحظورة وسجل شبكة الوكلاء ووجهات تشغيل الوكلاء وذاكرة إشعارات الحماية |
| `kilobat history clear --hour\|--today\|--all [--json]` | مسح سجلات المضيف هذه للساعة الأخيرة أو منذ منتصف الليل أو بالكامل؛ وقد يُسجّل النشاط المستقبلي مجددًا |
| `kilobat agent-log --watch [--agent claude] [--flagged] [--json]` | يسجل الأمر نفسه مباشرة في Terminal هذا دون التطبيق؛ لا يُحفظ شيء |
| `kilobat protect [status\|on\|off\|update] [--threats\|--trackers\|--agents] [--json]` | الحماية: حظر مضيفي البرامج الضارة والتصيّد والاحتيال المعروفين (Pro)، وأدوات التتبع في التطبيقات (مجانًا ومتوقف افتراضيًا)، وحارس الوكلاء (Pro)؛ ينزّل update القوائم الآن |
| `kilobat protect check <host> [--json]` | يتحقق مما إذا كان المضيف مدرجًا في قائمة تهديدات أو تتبّع، وأي قائمة، وما إذا كان Kilobat يحظره؛ يُنهي الأمر بالرمز 1 إذا حظره |
| `kilobat protect allow\|unallow <host>` | السماح لموقع ونطاقاته الفرعية بتجاوز جميع قوائم الحماية، أو التراجع عن ذلك |
| `kilobat agent-event <start\|working\|waiting\|done\|failed> [--agent name] [--stdin-json\|--json-arg]` | لخطافات الوكيل: يُخبر التطبيق ببدء تشغيل أو انتظاره لك أو انتهائه. صامت، وينتهي دائمًا بالرمز 0 |
| `kilobat why <url\|host> [--app <id>] [--proxy <url>] [--context container\|vm\|remote\|provider] [--failed-at <time>] [--error <text>] [--json]` | اعثر على الطبقة التي تمنع الاتصال: الشبكة والواجهة، والوكيل ووكيل التطبيق نفسه، وDNS، وقواعد Kilobat، وIPv4 وIPv6، وTLS، والخادم وكل إعادة توجيه، وما إذا كانت الشبكة تحظره أو ترفض الخدمة منطقتك. يطلب URL الدقيق؛ وتخفي المخرجات قيم الاستعلام. وكذلك kilobat doctor <url\|host> |
| `kilobat down [service\|host…] [--all] [--list] [--json]` | هل المشكلة لديهم أم لديّ؟ ما تبلّغ به صفحات الحالة العامة لـ Slack وZoom وGitHub وClaude وOpenAI ونحو سبعين خدمة أخرى الآن، وما إذا كانت كل منها تتصل من هنا: محظورة على هذه الشبكة أم غير متاحة في منطقتك؛ وعند عدم تحديد خدمة، يفحص خدمات التطبيقات الجارية على هذا الـ Mac |
| `kilobat explain <process\|host…> [--process name --host name] [--json]` | ماهية عملية macOS أو المضيف، وحجم حركة البيانات المعتاد، وما إذا كان حظره آمنًا وما الذي يتعطل، من قاعدة بيانات Kilobat على هذا الـ Mac. ويعرض الحقائق التي يعرفها Kilobat عما لا يعرفه |
| `kilobat conditions [--json]` | الشبكات محدودة البيانات ووضع البيانات المنخفضة وVPN وزمن الاستجابة والبطارية والحرارة وإمكانية إغلاق الغطاء، مع نصائح للعمليات الطويلة |

### التحكم

|  |  |
|---|---|
| `kilobat profile [travel\|work\|unrestricted]` | عرض ملفات التعريف أو اختيار أحدها |
| `kilobat allow\|block <bundle-id> [--minutes 1…1440] [--profile name]` | حفظ قاعدة تطبيق، مؤقتًا أو لملف تعريف آخر اختياريًا |
| `kilobat reset <bundle-id> [--profile name]` | إزالة قاعدة التطبيق ليتبع الإعداد الافتراضي |
| `kilobat rules [--profile name] [--json]` | قواعد ملف تعريف |
| `kilobat limit [GB] [--cycle session\|daily\|weekly\|monthly] [--reset-day N] [--alert 50,80,100]` | قراءة ميزانية بيانات هذه الشبكة أو تعيينها وموعد إعادة بدئها والتنبيه |
| `kilobat quota <bundle-id> <GB> [--upload] [--all-networks]` | تحديد بيانات تطبيق واحد لكل دورة ميزانية؛ يزيل quota <bundle-id> --remove الحد |
| `kilobat quota --list [--json]` | حصص التطبيقات وما استخدمه كل منها في هذه الدورة |
| `kilobat pack [status] [--json]` | حزم البيانات مثل eSIM للسفر، مع المتبقي واليوم الذي تنفد فيه كل حزمة وفق وتيرة الأيام الثلاثة الأخيرة |
| `kilobat pack add <GB> <days\|YYYY-MM-DD> [--network <name>] [--name <label>] [--start YYYY-MM-DD]` | إضافة حزمة بيانات على هذه الشبكة أو الشبكات التي رآها Kilobat أو أي شبكة يحتوي اسمها على نص معين |
| `kilobat pack correct <GB-left> [--pack <name>]` | ضبط المتبقي كما يذكر تطبيق شركة الاتصالات، لأن Kilobat يحتسب هذا الـ Mac فقط |
| `kilobat pack end [--pack <name>]` | إنهاء حزمة بيانات الآن؛ تبقى في السجل |
| `kilobat updaters [--json]` | برامج التحديث المتوقفة مؤقتًا على الشبكات محدودة البيانات، وبيانات التحديث التي مرّت رغم ذلك على هذه الشبكة، والتطبيقات التي تحدّث نفسها من داخلها |
| `kilobat updaters on\|off` | إيقاف البرامج المساعدة للتحديث مثل Google Updater وتحديث برامج macOS مؤقتًا عندما تكون الشبكة محدودة البيانات (مفعّل افتراضيًا)؛ تستمر التطبيقات في العمل |
| `kilobat settings kill-switch on\|off` | Pro: حظر الاتصالات الجديدة عند تعطل VPN؛ يتيح kill-switch-lan on\|off استمرار الوصول إلى الشبكة المحلية أثناء ذلك |
| `kilobat uploads [--json]` | التطبيقات التي ترفع بيانات كثيرة الآن، مع المعدل وما أرسلته حتى الآن والوقت المتبقي عند معرفة الإجمالي، وعمليات الرفع المؤجلة |
| `kilobat uploads hold <app> [--until unmetered\|fast\|fast:<Mbps>\|2h\|manual]` | تأجيل رفع تطبيق حتى توفر شبكة غير محدودة أو أسرع، أو لفترة، أو حتى تستأنفه (Pro)؛ يطلقه uploads resume <app> |
| `kilobat settings [name [value] ]` | قراءة الإعدادات أو تغييرها، مثل new-apps (السماح أو السؤال أو الحظر) وapple-software وauto-travel وpause-updaters وkill-switch وawake-on-power وpublic-ip (متوقف افتراضيًا) وspeed-streams وalerts وmenu-bar |
| `kilobat verdict <host> [--app <id>] [--port N] [--incoming] [--json]` | لماذا يسمح Kilobat باتصال أو يحظره: كل قاعدة تطابقه بترتيب فحص المرشّح والقاعدة الحاسمة والأمر الذي يغيّر كلًا منها؛ استخدم verdict --app <id> لقواعد التطبيق نفسه |
| `kilobat verdict --blocked [1…50] [--json]` | القواعد وراء أحدث المحاولات المحظورة، كما سجّلها المرشّح عند الحظر |
| `kilobat approvals [--json]` | التطبيقات التي تنتظر الموافقة عند السؤال عن التطبيقات الجديدة، مع الموقّع والوجهات |
| `kilobat approve\|deny <app-id> [--minutes 1…1440]` | حظر تطبيق منتظر فورًا، أو مطالبة الشخص بتأكيد السماح به في Kilobat |
| `kilobat block-host\|unblock-host <domain\|IP\|CIDR> [--app <id>]` | حظر نطاق (بما فيه النطاقات الفرعية، ويُقبل *.example.com) أو عنوان IP أو نطاق عناوين لكل التطبيقات أو لتطبيق واحد |
| `kilobat quit <PID> [--force]` | إنهاء عملية |

### الإعداد

|  |  |
|---|---|
| `kilobat open` | فتح تطبيق Mac |
| `kilobat doctor` | فحص التطبيق وفلتر الشبكة والمراقبة |
| `kilobat completion [zsh\|bash\|fish]` | طباعة نص إكمال لأوامر الصدفة |
| `kilobat mcp` | تشغيل خادم MCP لوكلاء الذكاء الاصطناعي عبر stdio |
| `kilobat update` | تحديث تثبيت Homebrew |

### متقدم

|  |  |
|---|---|
| `kilobat destinations [--pid PID] [--json]` | مآخذ العمليات المرصودة |
| `kilobat devices [--all] [--bonjour] [--json]` | أجهزة شبكتك، وكل منها جديد أو معروف أو غير معروف أو متجاهَل، مع نوعه ومدى يقين Kilobat؛ يضيف --all الأجهزة غير الموجودة الآن |
| `kilobat devices name <MAC> <name>` | تسمية جهاز |
| `kilobat devices mark <MAC> mine\|unknown\|ignored` | تحديد حالة جهاز جديد، كما يفعل تنبيه التطبيق |
| `kilobat devices type <MAC> <type>\|auto` | ضبط نوع الجهاز (camera, doorbell, tv, speaker, printer, plug, hub, console, phone, computer, drone, router, nas…)؛ يعيد auto تقدير Kilobat |
| `kilobat household [--json]` | أجهزة Mac المقترنة في التطبيق وما ينقله كل منها الآن؛ يبقى الاقتران في التطبيق |
| `kilobat smarthome [--json]` | شبكات Thread وموجّهاتها الحدودية وأجهزة Matter وHomeKit وما إذا كانت الشبكة جاهزة لـ Matter؛ للقراءة فقط |
| `kilobat trace <host> [--rounds 2…10] [--json]` | فحص مسار محدود بـ 12 قفزة؛ يتتبع --rounds عدة مرات ويعرض الفقد والتأخير لكل قفزة |
| `kilobat route-history --host <host> [--json]` | كل مسار محفوظ إلى مضيف، قفزة بقفزة مثل mtr: الفقد وأفضل ومتوسط وأسوأ تأخير وتغيّرات المسار ومكان بدء التأخير |
| `kilobat http-check <URL> [--json]` | أوقات DNS والاتصال وTLS والبايت الأول |
| `kilobat dns-benchmark` | أوقات استجابة المحللات |
| `kilobat lan-test <server> [--reverse] [--json]` | اختبار iperf3 لمدة خمس ثوانٍ إلى جهاز يشغّل iperf3 -s؛ يتطلب iperf3 الذي لا يثبته Kilobat أبدًا |
| `kilobat interfaces [--json]` | عدادات الواجهات الفعلية وVPN، كل على حدة |
| `kilobat capture <interface> <file.pcap>` | التقاط حزم محدود |
| `kilobat connection-rule allow\|block <app> <host> [port]` | حفظ قاعدة وجهة |
| `kilobat blocklist status\|import <path>\|clear` | إدارة قائمة حظر النطاقات |
| `kilobat wake <MAC-address>` | إرسال حزمة Wake-on-LAN |
| `kilobat spots [save <name>\|remove <id>]` | مواقع Wi-Fi المحفوظة |
| `kilobat outages / speed-history [--days N]` | الانقطاعات واختبارات السرعة المسجلة بصيغة JSON |

## البرمجة النصية وJSON

تتحول المخرجات تلقائيًا إلى JSON عند تمريرها عبر أنبوب، حتى لا تحلل البرامج النصية التنسيق المخصص للبشر. مرّر `--json` لتحديد ذلك صراحةً.

```
kilobat diagnose | jq .health            # "good" أو "degraded" أو "poor" أو "unknown"
kilobat status --watch --json             # كائن JSON واحد في كل سطر، كل ثانية
kilobat report --summary --days 7 --json  # الإجماليات اليومية وأكثر التطبيقات استخدامًا
kilobat report compare --total 40GB --period last-month --csv  # بجانب الرقم الذي يقدّمه مزوّد الخدمة
```

عيّن `NO_COLOR` لإيقاف الألوان. تتطلب تغييرات DNS موافقة مسؤول.