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

سطح أوامر kazma وkazma-tui وkazma-web الكامل، وكل علم، وأمثلة عاملة — كلها موثَّقة مقابل مصدر kazma-cli/.

1. نقاط الدخول

مُعرَّفة في pyproject.toml:73-76:

الأمر	الوحدة	ماهيته
`kazma`	`kazma_cli.main:main`	واجهة سطر الأوامر الأساسية (ask، وacp، وhub، وgateway، وswarm، وproject، وdocs، وcompletion، وupdate).
`kazma-tui`	`kazma_tui.app:main`	لوحة التحكم الطرفية Textual TUI.
`kazma-web`	`kazma_ui.app:main`	خادم واجهة الويب FastAPI (اسم مستعار لـ `kazma serve`).

ملاحظة عن الإطار: الأمر kazma ذو المستوى الأعلى يستخدم تحليلًا يدويًا لـ argv (سلسلة if/elif فوق sys.argv[1:] في main.py:39-94) — وليس Click. الشجرة الفرعية kazma hub وحدها تستخدم Click (kazma_core/hub/cli.py:104). يُنتزع الخيار المبكّر العام --no-banner قبل الإرسال (main.py:28-32).

2. `kazma` — الشجرة ذات المستوى الأعلى

kazma
├── (no args)              # banner + status + help hint
├── status                 # probe running server, print versions
├── doctor                 # which model and provider will be used, and will it work
├── acquisition status     # cached crawler errors, usage and credit evidence
├── serve [port]           # launch Web UI (uvicorn)
├── ask [options] <prompt> # in-process agent (no uvicorn)
├── acp                    # ACP JSON-RPC on stdio (Zed / JetBrains)
├── mcp                    # MCP server on stdio — the whole tool registry, behind the HITL gate
├── wizard                 # interactive skill-install wizard
├── hub ...                # skill hub (Click group)
├── agent-skills ...       # list, verify and sign installed Agent Skills
├── docs <build|serve>     # build/serve the Docusaurus docs site
├── completion ...         # shell tab-completion
├── project ...            # .kazma/ project config
├── gateway ...            # gateway control via REST
├── swarm ...              # swarm orchestration via REST
├── update                 # check/install CLI updates
├── migrate ...            # export/verify/import an installation
└── --help | -h | help     # print command list

2.1 `kazma` (بلا وسائط)

يطبع لافتة بدء التشغيل، ويُجري فحوصات الإعداد، ويطبع الحالة، وتلميحًا للمساعدة (main.py:35-37). يلتزم بـ --no-banner.

2.2 `kazma status`

يفحص /api/gateway/status و/api/swarm/status على الخادم قيد التشغيل، ويطبع إصدارات Python/كاظمه، ومسار الإعداد، وإصدارات الحزم الرئيسية (main.py:352-439).

kazma status

`kazma acquisition status`

اقرأ نتائج الزحف المحفوظة وحجوزات الطلبات والاستخدام المبلّغ وحداثة الرصيد في هذا التثبيت دون الاتصال بالمزوّدين:

kazma acquisition status
kazma acquisition status --job <retained-job-id> --json
kazma acquisition status --language ar

تبقى الرسوم المجهولة والأرصدة غير المدعومة غير متاحة. الحجوزات حدود عليا للطلبات وليست مالًا أُنفق. تخص السعة الحية عملية CLI هذه؛ وتنتمي أدلة المهام والمحاسبة المحفوظة إلى التثبيت. يخرج الأمر بـ 1 عند تعذر الحالة أو فشل الجاهزية وبـ 0 عند الجاهزية.

2.3 `kazma serve [port]`

يُطلق واجهة الويب عبر uvicorn kazma_ui.app:create_app --factory. المنفذ الافتراضي 8000. يرتبط بـ 127.0.0.1 عادة؛ ويتحوّل إلى 0.0.0.0 فقط عند ضبط KAZMA_SECRET (main.py:97-114, 110).

kazma serve            # 127.0.0.1:8000
kazma serve 9090       # 127.0.0.1:9090
KAZMA_SECRET=xxx kazma serve   # 0.0.0.0:8000 (approval endpoints protected)

الأمان: لا تُشغّل أبدًا kazma serve على 0.0.0.0 بدون KAZMA_SECRET. وإلا فستكون نقطة نهاية الموافقة HITL غير مُصدَّقة.

2.4 `kazma wizard`

يُشغّل معالج تثبيت المهارات التفاعلي (kazma_core.cli.wizard.SkillInstallationWizard، main.py:117-123).

2.5 `kazma docs`

يبني موقع توثيق Docusaurus أو يقدّمه ضمن docs/ (main.py:133-202).

kazma docs build        # npm install && npm run build
kazma docs serve        # npm run start (default port 3000)
kazma docs serve 4000   # custom port

2.6 `kazma ask [options] <prompt>`

يشغّل مشرف LangGraph داخل العملية (kazma_core.cli.ask). لا يبدأ uvicorn. تتدفّق الرموز إلى stdout؛ وتذهب أسطر الأدوات إلى stderr.

العلم	المعنى
`--workspace, -w PATH`	جذر مساحة العمل (الافتراضي: cwd)
`--yolo`	السماح بالأدوات الخطيرة دون HITL
`--plan`	دخول وضع التخطيط (للقراءة فقط حتى يخطّط النموذج)
`--json`	أحداث NDJSON على stdout (`token` / `tool_*` / `hitl` / `done`)
`--no-stream`	انتظار الردّ الكامل (مع `--json`، كائن واحد)
`--thread ID`	إعادة استخدام مُعرِّف خيط
`--model NAME`	تبديل النموذج لهذه العملية
`--acp`	خادم stdio لبروتوكول Agent Client Protocol (مثل `kazma acp`)

على TTY، تطلب الأدوات الخطيرة y/N (أو a = السماح لهذه الجلسة). مدخل stdin المُمرَّر عبر الأنبوب / kazma ask - يفشل مغلقًا إلا مع --yolo.

kazma ask "What files define the supervisor graph?"
kazma ask --plan "Add a rate limiter to the API"
kazma ask --json "fix the tests"
echo "summarize README.md" | kazma ask --json --no-stream -

2.7 `kazma acp`

بروتوكول Agent Client Protocol عبر JSON-RPC على stdio (initialize، وsession/new، وsession/prompt، وsession/cancel). يبثّ session/update (agent_message_chunk، وtool_call، وtool_call_update) ويطلب من المحرّر الموافقة على الأدوات الخطيرة عبر session/request_permission. ترسل أدوات الترقيع محتوى ACP diff (oldText / newText) كي يستطيع Zed عرض رزمة مراجعة. ويُلغي session/cancel الدور الجاري.

kazma acp
kazma ask --acp --workspace /path/to/repo

Zed — ~/.config/zed/settings.json (ويندوز: %APPDATA%\Zed\settings.json):

{
  "agent_servers": {
    "Kazma": {
      "type": "custom",
      "command": "kazma",
      "args": ["acp"]
    }
  }
}

افتح لوحة Agent، واختر Kazma، وابدأ خيطًا. تطلب الأدوات الخطيرة الموافقة في المحرّر (السماح مرة واحدة / السماح بالأداة لهذه الجلسة / رفض). يسمح خيار «لهذه الجلسة» بتلك الأداة وحدها في الخيط (30 دقيقة افتراضيًا، KAZMA_HITL_GRANT_TTL_SECONDS)، كما يفعل زر «السماح بالأداة» في بطاقة الويب؛ ولا يُطفئ الموافقات على الأدوات الأخرى أبدًا. والأداة التي تطلب الموافقة دائمًا (النشر على X) لا تعرض إلا السماح مرة واحدة والرفض. وفي الطرفية يسأل kazma ask بـ y/N/a، وa هو السماح نفسه بالأداة.

2.8 `kazma mcp`

خادم MCP على stdio يعرّض سجلّ الأدوات بأكمله (155 أداة) لأي عميل MCP — Claude Desktop أو محرّر أو وكيل آخر. يسلّم tools/call مباشرة إلى LocalToolRegistry.execute()، نقطة الاختناق نفسها التي تعيش فيها تفويض الالتزام، وخطافات PreToolUse، وقائمة سماح الأذونات، وناقل موافقة HITL. تتوقف الأدوات الخطيرة لبشرٍ عبر البوابة نفسها التي تستخدمها نافذة المحادثة — هذا هو الفرق عن kazma_gateway.mcp_server (“kazma-ide”)، خادم IDE الأقدم والأضيق الذي لا يستطيع check_sync() فيه إلا الحجب، دون طوابير أبدًا. راجع docs/MCP_SERVER.md.

{
  "mcpServers": {
    "kazma": { "command": "kazma", "args": ["mcp"] }
  }
}

متغير البيئة	المعنى
`KAZMA_MCP_TOOLS`	قائمة سماح مفصولة بفواصل، تُفرَض على `tools/call` كما على `tools/list`.
`KAZMA_MCP_ALLOW_UNGATED`	نشر الأدوات الخطيرة حتى بلا مسار موافقة موثَّق. الفشل-المُغلق هو الافتراضي: دون بوابة، تُحجَب الأدوات الخطيرة كليًا (تصبح 155 أداة 100)، فلا تُعلَن ثم تُرفَض.

تُطابَق المستويات مع destructiveHint / readOnlyHint الخاصة بـ MCP نفسه، فتُعرَض الأدوات الخطيرة كمدمِّرة في واجهة موافقة العميل دون قراءة وثائقنا.

2.9 `kazma doctor`

يجيب عن سؤال: أي نموذج سيستخدمه هذا التثبيت، وهل سيعمل؟ (kazma_cli/doctor.py). يطبع المزوّد والنموذج النشطين، والعنوان الذي يذهب إليه كل طلب، وهل يوجد مفتاح صالح للاستخدام، وهل سيبدّل سجلّ النماذج إلى مزوّد آخر. رمز الخروج 1 حين يفشل أي فحص، و0 في غير ذلك. وهو للقراءة فقط: لا يكتب أي إعداد ولا يفتح أي اتصال.

kazma doctor

2.10 `kazma agent-skills`

مهارات الوكيل (SKILL.md بصيغة agentskills.io) المثبتة في مجلدات المهارات التي يقرؤها كاظمه. تُفحص المهارة حين يفعّلها النموذج، وكل قائمة تعرض نتيجة ذلك الفحص:

الحالة	المعنى
`verified`	موقّعة بمفتاح هذا التثبيت ولم تتغير منذ ذلك. تُحمَّل.
`unsigned`	لم تُوقَّع قط. تُحمَّل مع تحذير في السجل.
`refused`	تغيّر محتواها منذ توقيعها، أو وقّعها مفتاح آخر: تغيّر `KAZMA_SECRET`، أو وقّعها تثبيت آخر لكاظمه (مجلد المستخدم مشترك)، أو أعاد أحدهم توقيعها. لا تُحمَّل، ولا تظهر في قائمة المهارات التي يراها النموذج.

الأمر الفرعي	الوصف
`kazma agent-skills list`	كل مهارة مثبتة مع نطاقها وحالتها ومصدرها. وبعد المهارة المرفوضة يأتي سبب رفضها ومجلدها.
`kazma agent-skills verify <folder>`	يفحص مهارة واحدة. رمز الخروج 1 حين تُرفض.
`kazma agent-skills sign <folder>...`	يوقّع المهارات بمفتاح هذا التثبيت (يكتب `.kazma-install.json` بجوار كل `SKILL.md`). يقبل عدة مجلدات؛ والمجلد الذي لا يحوي مهارة يُذكر باسمه وتُوقَّع البقية. لا توقّع إلا مهارة تثق بها: التوقيع كفالتك لها.

kazma agent-skills list
kazma agent-skills sign ~/.agents/skills/my-skill ~/.agents/skills/other-skill

3. `kazma completion`

توليد وتثبيت الإكمال التلقائي للغلاف (tab-completion) (main.py:224-286، completions.py).

الأمر الفرعي	الوصف
`kazma completion bash`	طباعة سكربت إكمال bash.
`kazma completion zsh`	طباعة سكربت إكمال zsh.
`kazma completion powershell` (أسماء مستعارة `pwsh`، `ps`)	طباعة سكربت `Register-ArgumentCompleter` لـ PowerShell.
`kazma completion install [shell]`	كشف الغلاف تلقائيًا (PowerShell على win32؛ وzsh/bash على POSIX) وتثبيته.
`--list-models`	طباعة أسماء النماذج المتاحة.
`--list-providers`	طباعة أسماء المُزوّدين.

الأعلام العامة (لبيانات الإكمال): --model، و--provider، و--yolo، و--verbose، و--no-banner، و--help، و-h.

4. `kazma project`

إعداد لكل مشروع عبر .kazma/ (main.py:289-328، project.py). كاظمه لا تقرأ هذه الملفات بعد: init ينشئها وshow / validate يتحقق منها، ولا تستخدمها أي جلسة وكيل. تحميل قواعد المشروع إلى الوكيل هو المسألة #20. (حتى 2026-09-28 كان ملف rules.yaml المُولَّد يقول إن قواعده “تُطبَّق على كل جلسة وكيل”.)

الأمر الفرعي	الوسائط	الوصف
`kazma project init [path]`	الافتراضي `.`	إنشاء `.kazma/` يحوي `rules.yaml`، و`context.md`، و`personality.yaml`، و`tools.yaml`، و`history/`. مُساوٍ (Idempotent).
`kazma project show [path]`	الافتراضي `.`	عرض إعداد المشروع المُحلَّل.
`kazma project validate [path]`	الافتراضي `.`	التحقق من وجود الملفات المطلوبة، وتحليل YAML، واحتواء `rules.yaml` على `language` و`git_branch`.

5. `kazma gateway`

التحكم في البوابة متعددة القنوات عبر REST. تقبل جميع الأوامر الفرعية --port N وتتحدث مع http://localhost:\{port\} (gateway.py).

5.0 علم `--port` (swarm / gateway)

تستهدف أوامر swarm وgateway الخادم على http://localhost:8000 افتراضيًا. يُحلّ المنفذ بهذه الأولوية:

المصدر	الأولوية
`--port N` (لكل أمر)	الأعلى
متغير البيئة `KAZMA_PORT`	الوسط
`8000` (الافتراضي)	الأدنى

إذا كان الخادم غير قابل للوصول، تطبع واجهة سطر الأوامر Server not running. Start with: kazma serve وتخرج برمز 1 (راجع رموز الخروج).

الأمر الفرعي	نقطة النهاية	الوصف
`kazma gateway status`	`GET /api/gateway/status`	جدول المحوّلات.
`kazma gateway start`	`POST /api/gateway/start`	بدء البوابة.
`kazma gateway stop`	`POST /api/gateway/stop`	إيقاف البوابة.
`kazma gateway restart`	إيقاف + 0.5 ثانية + بدء	إعادة تشغيل البوابة.
`kazma gateway refresh`	`POST /api/gateway/refresh-adapters`	إعادة بناء كل محوّلات المحادثة من الإعدادات المحفوظة، كما يفعل الإقلاع (والإعداد المحفوظ يسري وحده).

kazma gateway status
kazma gateway restart --port 9090

6. `kazma swarm`

تنسيق السرب عبر REST (swarm.py). أعلام القيمة: --model، و--provider، و--type، و--role، و--context، و--workers، و--aggregation، و--page، و--page-size، و--status، و--port، و--worker. المنطقية: --reset.

6.1 الحالة والعمّال

الأمر الفرعي	الوصف
`kazma swarm status`	`GET /api/swarm/status`.
`kazma swarm workers`	سرد العمّال.
`kazma swarm worker add <name> [--model --provider --type --role]`	`POST /api/swarm/workers`.
`kazma swarm worker spawn <name> <role> [--model --provider --type]`	`POST /api/swarm/workers/spawn`.
`kazma swarm worker remove <name>`	`DELETE /api/swarm/workers/\{name\}`.

6.2 أنماط الإرسال

الأمر الفرعي	`type`	الوصف
`kazma swarm dispatch <worker> <prompt> [--context C]`	`dispatch`	عامل واحد.
`kazma swarm broadcast <prompt> [--context C]`	`broadcast`	جميع العمّال.
`kazma swarm consult <prompt> --workers a,b [--context C]`	`consult`	آراء متوازية + تركيب.
`kazma swarm pipeline --workers a,b,c <prompt>`	`pipeline`	مراحل مرتّبة + سبورة مشتركة.
`kazma swarm fanout --workers a,b <prompt> [--aggregation strategy]`	`fan_out`	توازٍ + تجميع.

# Dispatch one task to the "researcher" worker
kazma swarm dispatch researcher "Summarize today's oil prices"

# Fan out to three workers and vote on the result
kazma swarm fanout --workers a,b,c --aggregation vote "Best API design?"

# Run the standard pipeline
kazma swarm pipeline --workers researcher,refiner,builder,validator "Build a CLI tool"

6.3 المهام والمقاييس والموثوقية

الأمر الفرعي	الوصف
`kazma swarm history [--type --status --page --page-size]`	`GET /api/swarm/tasks` (مُقسَّم إلى صفحات).
`kazma swarm task <id>`	`GET /api/swarm/tasks/\{id\}`.
`kazma swarm metrics [--worker W]`	`GET /api/swarm/workers/\{W\}/metrics` (أو `/metrics/all`).
`kazma swarm start` / `kazma swarm stop`	`POST /api/swarm/start` / `/stop`.
`kazma swarm approve <task_id>`	`POST /api/swarm/tasks/\{id\}/approve` (نقطة حفظ HITL).
`kazma swarm reject <task_id>`	`POST /api/swarm/tasks/\{id\}/reject`.
`kazma swarm circuit-breaker [worker] [--reset]`	`GET /api/swarm/circuit-breakers`، لكل عامل، أو `POST .../reset`.

7. `kazma update`

مسار ترقية المشغّل الأساسي (kazma_cli/update.py). فضِّله على git pull يدوي في تثبيتات الإنتاج/git. الدليل الكامل: تحديث كاظمه.

العلم	الغرض
`--check` / `-c`	تشغيل تجريبي: عرض التحديث المتاح
`--force` / `-f`	فرض المزامنة حتى لو كانت أحدث نسخة؛ وفي التثبيت المأخوذ من حزمة wheel لإصدار، إعادة تثبيت أحدث إصدار
`--yes` / `-y`	تخطّي التأكيد
`--reinstall` / `-r`	الحزم/الإضافات فقط (إصلاح بيئة افتراضية مُمحاة): النسخة المستنسخة تُعاد من نفسها؛ والتثبيت المأخوذ من حزمة wheel لإصدار يُعاد من إصداره هو (الوسم `v<version>`)، بعد التحقق من SHA-256
`--sync-main`	الخروج إلى `main` أولًا (أمان فروع الميزات)
`--accept-discard-local-commits`	السماح بإعادة التعيين الصارمة عندما تكون الالتزامات المحلية متقدمة على `origin/main`

يكتشف نوع التثبيت تلقائيًا:

حزمة wheel من إصدار (مثبّتة عبر pip، بلا نسخة git) ← يقرأ أحدث إصدار على GitHub لـ Mubder/kazma، وينزّل حزمة wheel الخاصة به من الإصدار، ويثبّتها (مع الإضافات المثبّتة لديك) فقط إذا طابقت بصمةُ SHA-256 ملفَّ SHA256SUMS في الإصدار، وبصمةَ GitHub نفسه للملف حين يذكرها. كاظمه ليست على PyPI؛ ولا يثبّت kazma update الحزمة kazma من هناك أبدًا. راجع SUPPLY_CHAIN.md.
git / مستودع موحَّد (monorepo) ← فحص مسبق (main فقط) ← stash مُسمّى ← إعادة تعيين صارمة إلى origin/main ← استعادة stash ← إعادة تثبيت الإضافات ← فحص لاحق (HEAD + استيراد kazma_cli). لا يعيد أبدًا تعيين فرع ميزة في مكانه بشكل صارم.

kazma update --check     # dry-run
kazma update --yes       # apply without prompting
kazma update --reinstall -y   # repair packages after a broken reinstall

يوقف التحديث الخادم العامل ويعيد تشغيله بنفسه. لا يمكن استبدال الحزم والخادم يحمّلها. وفي تثبيت يشرف عليه الحارس، ينتظر التحديث حتى لا تبقى أي دورة محادثة جارية، ويطلب من الحارس إيقاف كاظمه وإبقاءه متوقفًا ريثما تُثبَّت الحزم، ثم يشغّله من جديد. وإن فشل التثبيت بقي كاظمه متوقفًا، والإصلاح هو تشغيل الأمر نفسه مرة أخرى. ومن دون حارس، يرفض التحديث خادمًا يعمل: أوقفه أولًا. انظر تحديث كاظمه.

على Windows، شغّل صيغ التثبيت بمفسّر Python الخاص بالتثبيت: .venv\Scripts\python.exe -m kazma_cli update --yes (أو --reinstall -y). فإعادة التثبيت يجب أن تستبدل kazma.exe، وWindows لا يسمح باستبدال مشغِّل، ولا حتى بإعادة تسميته، ما دام يعمل. وإذا بدأ التحديث من kazma.exe، أو كان kazma-tui يعمل، يرفض التحديث قبل أن يثبّت أي شيء ويطبع الأمر الذي يجب استخدامه. أما --check فلا يثبّت شيئًا ويعمل من أي مكان.

8. `kazma migrate` — الترحيل بين الأجهزة

انقل تثبيتة كاظمه كاملة (الإعداد، والأسرار، والذاكرة، وسجلّ المحادثات، واللقطات، والأصول) بين الأجهزة/أنظمة التشغيل دون كسر صامت. راجع الترحيل للدليل الكامل والثوابت الثلاثة الحاملة (اقتران الخزنة، وترجمة المسارات، والاستيراد الذرّي).

kazma migrate export [--out PATH] [--no-assets]   # create a portable bundle
kazma migrate verify BUNDLE [--no-hash]           # check integrity without importing
kazma migrate import BUNDLE [--workspace PATH] [--reset-vault-key] [--dry-run]

الأمر الفرعي	الغرض
`export`	حزم التثبيتة الحالية في ملف `.zip` (ملفات SQLite + نسخة Postgres + الخزنة + الأصول)
`verify`	التحقق من بنية الحزمة، وبصمات sha256، والبيان (manifest)، وبصمة مفتاح الخزنة
`import`	الاستعادة إلى هذا الجهاز: staging ← إعادة كتابة المسار ← نسخ احتياطي ← تبديل ذرّي

مصادر Postgres: اضبط KAZMA_DB_CONTAINER ليُكتشَف pg_dump عبر docker exec. راجع الترحيل ← Postgres.

عدم تطابق مفتاح الخزنة: إذا اختلف مفتاح الخزنة في الحزمة عن مفتاح الهدف، يُجهَض الاستيراد. مرِّر --reset-vault-key للكتابة فوقه (يُنسخ vault.db الهدف الموجود احتياطيًا أولًا).

9. `kazma hub` — مركز المهارات (مجموعة Click)

الشجرة الفرعية الوحيدة القائمة على Click (kazma_core/hub/cli.py:104). خيارات المجموعة: --registry-path (متغير البيئة KAZMA_HUB_DB، الافتراضي ~/.kazma/hub/registry.db)، و--hub-url (متغير البيئة KAZMA_HUB_URL، الافتراضي https://hub.kazma.ai).

الأمر الفرعي	الوصف
`kazma hub register <path>`	تسجيل مهارة محلية.
`kazma hub search [query] [--capabilities --tags --author]`	البحث في السجلّ.
`kazma hub install <skill_id>`	غير مُنفَّذ: يقول ذلك ويخرج بالرمز 2 دون أن يثبّت شيئًا.
`kazma hub list`	سرد المهارات المثبَّتة.
`kazma hub info <skill_id>`	عرض تفاصيل المهارة.
`kazma hub validate <path> [--json]`	التحقق من بيان مهارة (manifest).
`kazma hub uninstall <skill_id>`	إزالة مهارة.
`kazma hub submit <path> [--json --source-url]`	إرسال `POST` إلى `\{hub_url\}/api/v1/skills/submit`.
`kazma hub status <submission_id> [--json]`	حالة الإرسال.
`kazma hub badge <skill_ref> [--json]`	عرض شارة الاعتماد.
`kazma hub certified [--json]`	سرد المهارات المُعتمدة.
`kazma hub stats [--json]`	إحصاءات السجلّ.
`kazma hub check-certification <path> [--json]`	فحص مهارة مقابل معايير الاعتماد.
`kazma hub sign <path> [--secret]`	توقيع HMAC-SHA256 لملف نقطة الدخول `.py` داخل البيان. يتطلّب `KAZMA_SECRET`. راجع المهارات وMCP والأدوات.

# Sign a skill (writes checksum + signature into skill_manifest.yaml)
KAZMA_SECRET=... kazma hub sign ./my-skill

# Search the registry
kazma hub search "oil pricing" --capabilities mcp

10. `kazma-tui`

يُطلق واجهة Textual الطرفية (TUI) (kazma_tui.app:main ← KazmaTUI().run()). التبويبات: لوحة التحكم، والمحادثة، والملفات، والتتبعات، والسرب، والإعدادات. يُهيّئ مُفردات ModelRegistry/SwarmEngine إذا أُطلق مستقلًا. يتضمّن نافذة منبثقة لموافقة HITL (widgets/hitl_modal.py).

kazma-tui
# or: python -m kazma_tui

11. `kazma-web`

اسم مستعار لإطلاق خادم واجهة الويب FastAPI مباشرة (kazma_ui.app:main). الافتراضي 127.0.0.1:8000؛ ويُحذّر إذا ارتبط بـ 0.0.0.0 بدون KAZMA_SECRET (app.py:900-906).

kazma-web

12. أوامر الشرطة المائلة (داخل المحادثة)

تُكتب هذه في تطبيق محادثة متصل (Telegram وDiscord وSlack). المرجع الكامل، بكل أمر فرعي وكل رد، هو أوامر الشرطة المائلة؛ ويسرد /help في أي محادثة الأوامر نفسها التي تعرضها قائمة ”/” في Telegram.

الأمر	الوصف
`/help`	سرد الأوامر حسب الفئة.
`/sessions` · `/session <#>` · `/new`	سرد الجلسات، أو تولّي جلسة، أو بدء جلسة جديدة (مشتركة مع واجهة الويب).
`/reset` · `/compact`	مسح المحادثة، أو ضغط سياقها الآن.
`/undo` · `/edit <text>`	حذف الرد الأخير، أو استبداله بنص مصحَّح.
`/replay list \| <iter> \| compare <a> <b> \| clear` · `/fork <iter>`	السفر عبر الزمن: اللقطات، والترجيع في المكان، والمقارنة، والمسح، والتفريع.
`/steer <text>` · `/steer! <text>` · `/abort` (`/stop`)	الإضافة إلى المهمة الجارية، أو مقاطعتها، أو التخلّي عنها.
`/long` · `/mission` · `/yolo` · `/unrestricted`	ميزانية جولات الأدوات وتجاوز الموافقات لهذه المحادثة.
`/plan`	وضع التخطيط: الفحص والاقتراح، ثم التنفيذ عند الموافقة.
`/hitl approve \| deny \| approve_task`	الرد على موافقة معلّقة من المحادثة.
`/model` (`/models`)	عرض النموذج وتبديله (قائمة اختيار على Telegram).
`/status`	اتصال كل تطبيق محادثة، والطابور، والرسائل قيد المعالجة.
`/memory` · `/memory off \| on`	الحقائق المحفوظة وما إذا كانت هذه المحادثة مُتذكَّرة؛ إبقاؤها خارج الذاكرة، أو السماح بعودتها.
`/cost`	رموز هذه المحادثة وكلفتها، من سجل استدعاءات النموذج.
`/context`	مقدار ما تملؤه هذه المحادثة من نافذة النموذج.
`/config` · `/personality`	معالج الإعدادات؛ تغيير النموذج أو الذاكرة أو خوادم MCP أو الشخصية مقصور على المشرفين.
`/research` · `/swarm` · `/ide` · `/kb` · `/documents` · `/skill`	البحث، وإرسال السرب، ومساحة العمل، ومكتبة المعرفة، والمستندات، ومهارات الوكيل.

يشغّل عميل Slack أوامر / بنفسه، لذا تُجاب الموافقات على Slack بـhitl approve أو hitl deny، بلا /. راجع البوابات والمنصات.

13. رموز الخروج

الرمز	المعنى
`0`	نجاح.
`1`	فشل عام / خادم غير قابل للوصول (تطبع أوامر swarm وgateway الرسالة `Server not running. Start with: kazma serve` وتخرج برمز `1` عندما لا يكون خادم WebUI قيد التشغيل — ابدأه أولًا عبر `kazma serve`).
`2`	خطأ وسيطات/استخدام (Click، الشجرة الفرعية `kazma hub` فقط).

أوامر swarm وgateway عملاء REST: تخرج برمز غير صفري كلما لم يكن خادم WebUI قيد التشغيل. ابدأ الخادم دائمًا (kazma serve) قبل استدعائها.

ملاحظات تدقيق التوثيق

نص --help يطبع “Kazma CLI v0.2.0” (main.py:75) بينما pyproject.toml هو 0.3.0. انحراف معروف.
kazma hub هي الشجرة الفرعية الوحيدة القائمة على Click. جميع الأوامر الأخرى تحليل يدوي لـ argv — وقد يكون ترتيب الأعلام وسلوك --help أقل انتظامًا من واجهة سطر أوامر Click خالصة.
/undo و/edit كعبان (stubs) (slash_commands.py:257, 267) — حاضران في القائمة لكنهما صراحةً “غير مُنفَّذين بعد”.

يقرأ kazma acquisition status [--job ID] [--json] [--language en|ar] الأدلة المحلية المحفوظة. يحدّث kazma acquisition credits رصيد حساب Firecrawl صراحة عبر المسار البعيد المسموح ثم يعرض الحالة المحفوظة. تعرض الإعدادات وTUI الإجراء الصريح نفسه. تبقى الرسوم غير المدعومة مجهولة.

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

1. نقاط الدخول

2. kazma — الشجرة ذات المستوى الأعلى

2.1 kazma (بلا وسائط)

2.2 kazma status

kazma acquisition status

2.3 kazma serve [port]

2.4 kazma wizard

2.5 kazma docs

2.6 kazma ask [options] <prompt>

2.7 kazma acp

2.8 kazma mcp

2.9 kazma doctor

2.10 kazma agent-skills

3. kazma completion

4. kazma project

5. kazma gateway

5.0 علم --port (swarm / gateway)

6. kazma swarm