مرجع CLI

أوامر للبشر.
نتائج للذكاء الاصطناعي.

lean-ctx يعمل تلقائياً بعد الإعداد. لكن عندما تريد التحكم، هذه الأوامر في انتظارك.

الأساسيات

الأوامر الأساسية

lean-ctx setup

إعداد لمرة واحدة. يكتشف تلقائياً الشل (zsh/bash/fish)، يجد أدوات AI المثبتة، يُهيئ MCP وShell Hooks. نفّذه مرة واحدة ولا تفكر فيه مجدداً.

نفّذ مرة واحدة بعد التثبيت
lean-ctx init

إعداد سريع لأداة AI معينة. استخدم --agent cursor أو --agent claude أو --agent codex أو --agent gemini لتهيئة MCP لتلك الأداة مباشرة.

بديل لكل وكيل عن setup
lean-ctx gain

اعرض لوحة التوفير. إجمالي توفير الرموز، معدلات الضغط، أهم الأوامر، وتقديرات التكلفة بالدولار. مستمر عبر جميع الجلسات.

تحقق في أي وقت
اعرف بالضبط ما توفره

المراقبة و التحليلات

lean-ctx gain

لوحة توفير شاملة مع عدد الرموز ومعدل الضغط وأهم الأوامر وتتبع التكلفة بالدولار.

$ lean-ctx gain

◆ lean-ctx Token Savings Dashboard

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

1.7M saved 76.8% rate $4.25 USD

Top Commands

curl 48x ████████████ 728K

git 34x ██████ 375K

lean-ctx gain --live

لوحة مباشرة تُحدّث تلقائياً. تُحدّث كل ثانيتين بينما توفر أدوات AI الرموز في الوقت الفعلي.

● LIVE

$ lean-ctx gain --live

◆ lean-ctx LIVE refreshing every 2s

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

1.7M saved ▁▃█▇██▁█

Session: 42 cmds | 89.2K saved | 94.1% rate

Press q to quit

lean-ctx gain --graph

مخطط توفير لـ 30 يوماً مع أعمدة يومية وخطوط مصغرة وعرض الاتجاهات. شاهد مسار توفيرك.

$ lean-ctx gain --graph

Token Savings (30 days)

03-20██████████████████████ 1.0M

03-21███████████████ 690K

03-22████████████████████████ 1.1M

03-23 9.4K

03-24██████████████████████ 1.7M

lean-ctx dashboard

لوحة ويب على localhost:3333. رسوم بيانية تفاعلية وسجل الجلسات ومراقبة في الوقت الفعلي في متصفحك.

$ lean-ctx dashboard

◆ lean-ctx Dashboard

→ http://localhost:3333

Interactive charts, session history, command breakdown

Press Ctrl+C to stop

lean-ctx wrapped

"Spotify Wrapped" لتوفير الرموز. تقارير جميلة وقابلة للمشاركة مع إحصاءاتك الشاملة وأهم الأوامر وإنجازات الضغط الشخصية.

weekly monthly lifetime

$ lean-ctx wrapped monthly

◆ Your March 2026 Wrapped

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

4.9M tokens saved

3,241 commands compressed

$12.16 USD saved

Top pattern: curl (97% compression)

You're in the top 5% of lean-ctx users

تحقق وحسّن

التشخيصات

lean-ctx doctor

يجري 8 فحوصات تثبيت - الملف الثنائي، Shell Hook، إعداد MCP، ملف الإحصاءات، مجلد الكاش، الشل المدعومة، اكتشاف أدوات AI، وفحص الإصدار.

Binary installed

Shell hook active (zsh)

MCP config (Cursor)

Stats persistence

Cache directory

Data directory writable

Project detection

Graph index

Search index

Agent hooks

Version up to date

All 11 checks passed

lean-ctx discover

يفحص سجل الشل بحثاً عن أوامر يمكن أن تستفيد من الضغط لكنها لا تُعترض حالياً.

Found 12 uncompressed commands:

kubectl - 34 calls, ~89% savings possible

helm - 12 calls, ~76% savings possible

terraform - 8 calls, ~82% savings possible

Run setup to enable these

lean-ctx benchmark run

يقيس التوفير الحقيقي للرموز في قاعدة الكود باستخدام tiktoken (o200k_base). أرقام دقيقة، لا تقديرات.

src/auth.ts (123 lines)

full: 3,517 → 3,517 (0%)

map: 3,517 → 412 (88%)

signatures: 3,517 → 252 (93%)

entropy: 3,517 → 312 (91%)

تحكم كامل

أوامر المستخدم المتقدم

الأمر الوصف
lean-ctx init --agent <name> إعداد MCP سريع لأداة ذكاء اصطناعي معينة (cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains)
lean-ctx read <file> -m <mode> قراءة أي ملف بوضع ضغط (full, map, signatures, diff, aggressive, entropy). القراءات المخزنة مؤقتاً تعيد ~13 رمزاً. استخدم --fresh لتجاوز ذاكرة التخزين المؤقت.
lean-ctx diff git diff مضغوط - مخرجات منظمة مع ملخصات التغييرات
lean-ctx grep <pattern> بحث أنماط فعال بالرموز مع سياق مضغوط
lean-ctx find <pattern> البحث عن الملفات بالاسم - نتائج مضغوطة مع عدد الملفات
lean-ctx ls قائمة المجلدات كخريطة شجرية مضغوطة
lean-ctx -c "<cmd>" ضغط أي مخرجات أوامر شل عبر lean-ctx
lean-ctx config set <key> <value> ضبط إعدادات lean-ctx - فترات النقاط المرجعية، مدة الكاش، وضع CRP
lean-ctx cache [stats|clear|invalidate] إدارة ذاكرة التخزين المؤقت لـ CLI - عرض الإحصائيات أو مسح الإدخالات أو إبطال مسارات محددة
lean-ctx setup إعداد بأمر واحد - يهيئ خطافات shell، MCP للمحرر، ويتحقق من أن كل شيء يعمل

مستعد لرؤية توفيراتك؟

ثبّت lean-ctx، نفّذ setup، وابدأ بتوفير الرموز فوراً. تحقق من لوحتك بـ gain متى شئت.