🇸🇦 العربية | 🇬🇧 English

☁️ eidcloud-cli

Universal Polyglot Master CLI and Autonomous Ecosystem Orchestrator.
Unifies all 49+ specialized EIDCloud micro-engines into a single, high-performance command line interface with zero external vendor dependencies.

---

🏛️ Ecosystem Architecture

flowchart TD
    CLI["☁️ eidcloud (Master CLI)"]
    
    subgraph Core["Core Engine"]
        DISPATCHER["Dispatcher & Runner"]
        REGISTRY["Plugin Registry & Auto-Discovery"]
        PIPELINES["Composite Pipeline Orchestrator"]
    end
    
    subgraph Domains["Ecosystem Domains (49+ Modular Tools)"]
        AI["🤖 AI & Autonomous Agents\n(agent, router, memory, rag, sim...)"]
        NLP["🌍 Pan-Arabic Computational NLP\n(opt, norm, morph, eval, ocr...)"]
        MEDIA["🎥 Media & Audio/Video\n(audio, video, voice, sub, lipsync...)"]
        SEC["🛡️ Security, AST & Code Intel\n(sec, secrets, graph, archaeologist...)"]
        DATA["💾 Data & Storage Engineering\n(db, schema, fake, sync, transformer...)"]
        SYS["⚙️ Systems & Infrastructure\n(micro, server, troubleshoot, job...)"]
    end
    
    CLI --> Core
    Core --> Domains

Loading

---

🚀 Quick Installation

Single-Command One-Liner

Windows (PowerShell):

irm https://raw.githubusercontent.com/shadialhasan/eidcloud-cli/main/install.ps1 | iex

Linux / macOS (Bash):

curl -fsSL https://raw.githubusercontent.com/shadialhasan/eidcloud-cli/main/install.sh | bash

Via Git Submodules

git clone --recurse-submodules https://github.com/shadialhasan/eidcloud-cli.git
cd eidcloud-cli
php bin/eidcloud doctor

---

🛠️ Usage & Core Commands

# Verify entire ecosystem health and dependencies
eidcloud doctor

# Browse all 49+ tools categorized by domain
eidcloud list

# Search across tools by capability or topic
eidcloud search arabic

# Run composite multi-tool pipeline
eidcloud pipeline audit ./src/

# Output machine-readable JSON
eidcloud list --json

---

⚡ Popular Tool Shortcuts (Aliases)

Alias	Target Plugin	Purpose
eidcloud agent	eidcloud-agent-runtime	Lightweight autonomous AI agent runner
eidcloud opt	eidcloud-arabic-token-optimizer	Arabic text compressor (saves 25-40% LLM tokens)
eidcloud sec	eidcloud-security-scanner	Static application security scanner (SAST)
eidcloud secrets	eidcloud-secret-hunter	High-entropy secret & API key leak scanner
eidcloud video	eidcloud-video-pipeline	Modular video translation & dubbing pipeline
eidcloud db	eidcloud-json-db	Embedded ACID JSON document database
eidcloud git	eidcloud-git-doctor	Git repository forensics & hygiene auditor
eidcloud micro	eidcloud-micro	Sub-100KB zero-dependency micro-framework

---

🧩 Polyglot Extensibility

eidcloud-cli uses runtime fingerprint detection to execute tools regardless of the underlying language:

• PHP 8.2+: Dispatched via php runtime (composer.json).
• Python 3: Dispatched via python (pyproject.toml / requirements.txt).
• Node.js: Dispatched via node (package.json).
• Go / C# / Rust: Dispatched directly as native compiled binaries.

To install a new plugin:

eidcloud plugin add https://github.com/shadialhasan/eidcloud-new-tool.git

---

🧪 Testing

php tests/run_tests.php

---

👤 Author & Maintainer

Eng. MHD. Shadi AL-Hasan

• Role: Executive CTO & Enterprise Solutions Architect
• Email: mhd.shadi.alhasan@gmail.com
• Phone / WhatsApp: +963934005922
• Location: Damascus, Syria
• GitHub: shadialhasan

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2026 MHD. Shadi AL-Hasan. All rights reserved.