تصفح بشكل طبيعي ← يسجل Neo كل حركة API ← يتم إنشاء المخطط تلقائيًا ← يعيد الذكاء الاصطناعي تشغيل APIs مباشرة
                                                                      ← أو يقود واجهة المستخدم عبر شجرة a11y

git clone https://github.com/4ier/neo.git
cd neo && npm install && npm run build
npm link  # يجعل `neo` متاحًا عالميًا

# تثبيت Lightpanda
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux
chmod +x lightpanda && sudo mv lightpanda /usr/local/bin/

# تكوين Neo لاستخدام Lightpanda
# في ~/.neo/config.json:
# { "chromePath": "/usr/local/bin/lightpanda", "browserType": "lightpanda", "cdpPort": 9222 }

neo start    # يشغل خادم CDP الخاص بـ Lightpanda
neo connect  # اتصل به
neo open https://example.com
neo snapshot # شجرة a11y كاملة

# --- الاتصال والجلسات ---
neo connect [port]                          # الاتصال بـ CDP، حفظ الجلسة
neo connect --electron <app-name>           # اكتشاف منفذ CDP لتطبيق Electron تلقائيًا
neo launch <app> [--port N]                 # تشغيل تطبيق Electron مع تمكين CDP
neo discover                                # العثور على نقاط نهاية CDP يمكن الوصول إليها على localhost
neo sessions                                # عرض الجلسات المحفوظة
neo tab                                     # عرض أهداف CDP في الجلسة النشطة
neo tab <index> | neo tab --url <pattern>   # تبديل هدف علامة التبويب النشطة
neo inject [--persist] [--tab pattern]      # حقن سكريبت التقاط Neo في الهدف

# --- الالتقاط وحركة المرور ---
neo status                                  # نظرة عامة على البيانات الملتقطة
neo capture summary                         # نظرة عامة سريعة
neo capture list github.com --limit 10      # عرض المعرفات لإعادة التشغيل/التفاصيل
neo capture list --since 1h                 # مرشح زمني
neo capture domains
neo capture search "CreateTweet" --method POST
neo capture watch x.com                     # متابعة حية (مثل tail -f)
neo capture stats x.com                     # تحليل الأسلوب/الحالة/التوقيت
neo capture export x.com --since 2h > x.json
neo capture export x.com --format har > x.har  # HAR 1.2 لـ Postman/devtools
neo capture import x-captures.json
neo capture prune --older-than 7d
neo capture gc x.com [--dry-run]            # إزالة التكرارات الذكية

# --- إعادة تشغيل API والتنفيذ ---
neo replay <capture-id> --tab x.com         # إعادة تشغيل استدعاء ملتقط
neo exec <url> --method POST --body '{...}' --tab example.com --auto-headers
neo api x.com HomeTimeline                  # استدعاء ذكي (بحث في المخطط + مصادقة تلقائية)

# --- المخطط والتحليل ---
neo schema generate x.com                   # إنشاء من الالتقاطات
neo schema generate --all                   # دفعة لجميع النطاقات
neo schema show x.com [--json]
neo schema openapi x.com                    # تصدير مواصفات OpenAPI 3.0
neo schema diff x.com                       # التغييرات عن الإصدار السابق
neo schema coverage                         # النطاقات مع/بدون مخططات
neo label x.com [--dry-run]                 # تسميات دلالية لنقاط النهاية
neo flows x.com [--window 5000]             # أنماط تسلسل استدعاءات API
neo deps x.com [--min-confidence 1]         # تبعيات البيانات من الاستجابة إلى الطلب
neo workflow discover|show|run <name>       # اكتشاف سير العمل متعدد الخطوات وإعادة التشغيل
neo suggest x.com                           # تحليل قدرات الذكاء الاصطناعي
neo export-skill x.com                      # إنشاء SKILL.md جاهز للعامل

# --- أتمتة واجهة المستخدم (v2) ---
neo snapshot [-i] [-C] [--json]             # شجرة a11y مع تعيين @ref
neo click @ref [--new-tab]                  # النقر على العنصر بواسطة @ref
neo fill @ref "text"                        # مسح + ملء الإدخال
neo type @ref "text"                        # إضافة نص إلى الإدخال
neo press <key>                             # مفتاح لوحة المفاتيح (يدعم Ctrl+a، Enter، إلخ.)
neo hover @ref                              # تحويم المؤشر فوق العنصر
neo scroll <dir> [px] [--selector css]      # التمرير حسب الاتجاه
neo select @ref "value"                     # تعيين القيمة في القائمة المنسدلة
neo screenshot [path] [--full] [--annotate]  # التقاط لقطة شاشة
neo get text @ref | neo get url | neo get title  # استخراج معلومات
neo wait @ref | neo wait --load networkidle | neo wait <ms>  # انتظار العنصر/التحميل/الوقت

# --- التفاعل مع الصفحة ---
neo read github.com                         # استخراج نص قابل للقراءة
neo eval "document.title" --tab github.com  # تشغيل JS في الصفحة
neo open https://example.com                # فتح عنوان URL

# --- المحاكاة والجسر ---
neo mock x.com [--port 8080 --latency 200]  # خادم محاكاة من المخطط
neo bridge [--json] [--interactive]          # تدفق التقاط WebSocket في الوقت الحقيقي

# --- التشخيص ---
neo doctor                                  # فحص Chrome، الإضافة، المخططات
neo reload                                  # إعادة تحميل الإضافة من CLI
neo tabs [filter]                           # عرض علامات التبويب المفتوحة في Chrome

# تشغيل VS Code مع CDP والاتصال
neo launch code --port 9230
neo snapshot                # رؤية شجرة إمكانية الوصول في VS Code
neo click @14               # النقر على عنصر قائمة

# أو الاتصال بتطبيق Electron قيد التشغيل بالفعل
neo connect --electron slack

# حقن سكريبت التقاط Neo في أي هدف CDP
neo inject --persist        # يبقى بعد التنقل بين الصفحات
neo inject --tab slack      # استهداف علامة تبويب محددة

# يتم حفظ الجلسات تلقائيًا. التبديل بينها باستخدام --session:
neo --session vscode snapshot
neo --session chrome api x.com HomeTimeline

# 1. خذ لقطة — كل عنصر تفاعلي يحصل على @ref
neo snapshot
#  @1  button "تسجيل الدخول"
#  @2  textbox "بحث"
#  @3  link "التسعير"

# 2. تفاعل باستخدام @ref
neo click @1
neo fill @2 "عوامل الذكاء الاصطناعي"
neo press Enter
neo screenshot results.png --full

┌─────────────────────────────────────┐
│  Chrome / Electron App (CDP)         │
│                                      │
│  inject/interceptor.ts               │
│    ├─ يراقب fetch & XHR              │
│    ├─ يعترض WebSocket/SSE            │
│    ├─ يتتبع مشغلات DOM (click →      │
│    │   ارتباط API)                   │
│    └─ يسجل كامل الطلب/الاستجابة      │
│                                      │
│  content/index.ts                    │
│    └─ يربط الصفحة ↔ الإضافة          │
│                                      │
│  background/index.ts                 │
│    ├─ يحفظ في IndexedDB (Dexie)      │
│    ├─ حد لكل نطاق (500 إدخال)        │
│    └─ عميل WebSocket Bridge          │
│                                      │
└──────────────┬──────────────────────┘
               │ بروتوكول أدوات المطورين Chrome
┌──────────────┴──────────────────────┐
│  CLI: neo (Node.js)                  │
│                                      │
│  الطبقة 1: التقاط API وإعادة التشغيل │
│  ├─ neo capture → إدارة حركة المرور │
│  ├─ neo schema  → اكتشاف API        │
│  ├─ neo exec    → تنفيذ في المتصفح  │
│  ├─ neo api     → استدعاء مخطط ذكي  │
│  ├─ neo replay  → إعادة تشغيل الملتقط│
│  └─ neo flows/deps → تحليل الأنماط  │
│                                      │
│  الطبقة 2: أتمتة واجهة المستخدم (v2) │
│  ├─ neo snapshot → شجرة a11y + @refs │
│  ├─ neo click/fill/type/press/hover  │
│  ├─ neo scroll/select/screenshot     │
│  └─ neo get/wait                     │
│                                      │
│  إدارة الجلسات                       │
│  ├─ neo connect/launch/discover      │
│  ├─ neo tab → تبديل الهدف           │
│  └─ neo inject → حقن السكريبت       │
│                                      │
└──────────────┬──────────────────────┘
               │
┌──────────────┴──────────────────────┐
│  وكيل الذكاء الاصطناعي (OpenClaw / أي LLM) │
│  ├─ API أولاً: مخطط → exec/api       │
│  ├─ واجهة مستخدم احتياطية: لقطة → نقر │
│  └─ أتمتة ثنائية القناة              │
└──────────────────────────────────────┘

# 1. تصفح X بشكل طبيعي — Neo يلتقط طفرات GraphQL
neo schema show api.x.com

# 2. ابحث عن نقطة نهاية CreateTweet
neo capture search "CreateTweet" --method POST

# 3. أعد التشغيل باستخدام المصادقة الأصلية (ملفات تعريف الارتباط موروثة تلقائيًا)
neo replay abc123 --tab x.com

# 4. أو أنشئ استدعاء جديدًا مع رؤوس مصادقة مكتشفة تلقائيًا
neo exec "https://x.com/i/api/graphql/.../CreateTweet" \
  --method POST --auto-headers \
  --body '{"variables":{"tweet_text":"مرحباً من Neo!"},...}'

neo schema show github.com
# الإخراج يشمل:
#   POST /repos/:owner/:repo/star  (3x, 280ms)
#     ← click button.js-social-form "Star" (3x)

neo capture watch api.openai.com
# 14:23:01  POST 200 /v1/chat/completions (1230ms)
# 14:23:05  SSE_MSG 200 /v1/chat/completions (0ms) [sse]