Skip to content
Back to search

https://github.com/fazah-arsenal/github-ai-arsenal

SkillWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fazah-arsenal--github-ai-arsenal/badge.svg)](/listings/fazah-arsenal--github-ai-arsenal)

HTML

<a href="/listings/fazah-arsenal--github-ai-arsenal"><img src="/api/listings/fazah-arsenal--github-ai-arsenal/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

🐍 PyPI (Cross-Platform β€” Recommended)

pip install fazah-arsenal

*Or run any command immediately without installing via `uvx`:*

uvx fazah-arsenal doctor

🐳 Docker (Instant Containerized MCP Server)

docker run -i --rm fazaharsenal/github-ai-arsenal

Windows (PowerShell Installer)

irm "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.ps1" | iex

*(Or locally after downloading: `.\install.ps1`)*

Linux / macOS

curl -fsSL "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.sh" | bash

*(Or locally: `chmod +x install.sh && ./install.sh`)*

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md Β· Manifest Β· 71 lines
  1. ---
  2. name: github-ai-arsenal
  3. description: Master GitHub AI Toolbox Skill v6.5.1 (by FAZAH | @testtttttttt11222) equipping any AI agent with 20,078+ real, curated GitHub tools across 37 domains, a 19-tool zero-dependency Native MCP Server (+ 4 Resources & 3 Prompts), 1-Call Autonomous Tool Broker (`fazah g`), Deep Supply-Chain Security Scanner (`fazah scan`), Local Web UI (`fazah ui`), Project Advisor (`fazah az`), Isolated Sandbox (`fazah try`), Self-Updater (`fazah up`), and instant offline BM25 search.
  4. metadata:
  5. version: "6.5.1"
  6. author: "FAZAH"
  7. telegram: "@testtttttttt11222"
  8. email: "mhamadabdalla150150@gmail.com"
  9. indexed_tools: "20,078+"
  10. mcp_server: "scripts/mcp_server.py"
  11. compatible_with: "DeepSeek Harness, Antigravity, Claude Code, Codex, Cursor, Windsurf"
  12. ---
  13. # GitHub AI Arsenal v6.5.1 (`github-ai-arsenal`)
  14. **Developed by FAZAH** (`@testtttttttt11222` | `mhamadabdalla150150@gmail.com`)
  15. The ultimate AI Agent Toolbox: gives any AI agent instant access to **20,078+ real GitHub tools**, a **19-tool Native MCP Server**, **1-command project scaffolding**, **side-by-side repo comparisons**, and **repository security audits** with zero external dependencies.
  16. ---
  17. ## 1. Native MCP Server (`scripts/mcp_server.py` β€” 19 Tools)
  18. Inject automatically into `.mcp.json`:
  19. ```bash
  20. python scripts/gh_arsenal.py mcp-inject arsenal
  21. ```
  22. Exposed MCP Tools:
  23. 1. `arsenal_give_tool`: 1-Call Autonomous Tool Broker with security scan, code snippet, and auto-pull.
  24. 2. `arsenal_learn`: Adaptive mistake-learning reflex (penalize broken tools, route to working alternatives).
  25. 3. `arsenal_mistakes`: List all recorded tool mistakes and learned fixes.
  26. 4. `arsenal_recommend`: Arabic/English intelligent tool recommender.
  27. 5. `arsenal_search_offline`: Instant BM25 offline search across 20,078+ repositories.
  28. 6. `arsenal_deep_scan`: Deep supply-chain security scan of install/build scripts.
  29. 7. `arsenal_get_snippet`: Extract runnable code snippets from README without full downloads.
  30. 8. `arsenal_memory`: Agent experience memory (list, clear, log tool outcomes).
  31. 9. `arsenal_analyze_project`: Detect missing tools/MCP servers for current project folder.
  32. 10. `arsenal_stack`: Browse 8 turnkey project stacks.
  33. 11. `arsenal_scaffold_stack`: Generate a full starter project folder (`README.md`, `setup_stack.ps1`, `.env.example`, `.mcp.json`).
  34. 12. `arsenal_quickstart`: Auto-detect ecosystem and output ready install/run commands for any repo.
  35. 13. `arsenal_compare`: Compare 2+ repositories side-by-side (Trust Score, Stars, License, Recency).
  36. 14. `arsenal_audit_repo`: Trust Score (0-100) and security risk audit before pulling code.
  37. 15. `arsenal_bookmark`: Save, list, or remove favorite GitHub tools with notes.
  38. 16. `arsenal_mcp_inject`: Safely inject any MCP server into `.mcp.json` with backup.
  39. 17. `arsenal_inspect_repo`: Inspect metadata, files, and README/SKILL.md without cloning.
  40. 18. `arsenal_pull_repo`: Download and unpack repo ZIP without git.
  41. ---
  42. ## 2. Short CLI Commands (`fazah` or `python scripts/gh_arsenal.py`)
  43. ```bash
  44. fazah g "scrape dynamic javascript websites" # 1-call tool delivery with security scan
  45. fazah mem mistakes # Show all learned tool failures & fixes
  46. fazah ui # Launch local interactive Web dashboard
  47. fazah doc # Check local runtimes & index health
  48. fazah info # Breakdown of 20,078+ tools across 37 domains
  49. fazah r "telegram bot and web scraping" # Smart Arabic/English recommender
  50. fazah m -q "postgres vector" -n 10 # Instant offline BM25 search
  51. fazah q unclecode/crawl4ai # Auto-detect install & run commands
  52. fazah cmp unclecode/crawl4ai mendableai/firecrawl # Side-by-side repo comparison
  53. fazah a modelcontextprotocol/servers # Security & Trust Score (0-100) audit
  54. fazah scan unclecode/crawl4ai # Deep supply-chain security scan
  55. fazah st saas-ai -s ./my-saas-app # Scaffold turnkey project stack
  56. fazah bm add unclecode/crawl4ai -m "Best" # Bookmark favorite tools
  57. fazah mi arsenal # Inject MCP config into .mcp.json
  58. fazah i danielmiessler/fabric # Inspect repo without cloning
  59. fazah p unclecode/crawl4ai -d ./tools # Pull repo ZIP without git
  60. fazah is anthropics/skills # Install repo as local Agent Skill
  61. ```
README.md Β· README Β· 364 lines Β· 3 findings marked
  1. <div align="center">
  2. <img src="assets/fazah-cover.jpg" alt="FAZAH AI Arsenal v6.5.1 β€” 20,078+ GitHub Tools & 19-Tool Native MCP Server" width="100%"/>
  3. <br/>
  4. # ⚑ FAZAH AI Arsenal v6.5.1 (`github-ai-arsenal`)
  5. ### **Autonomous AI Tool Broker & 19-Tool Native MCP Server (+ Prompts & Resources) β€” 20,078+ GitHub Tools, 1-Call Delivery (`fazah g`), Code Snippet Extractor, Isolated Sandbox, Local Web UI & Security Scanner**
  6. [![PyPI](https://img.shields.io/pypi/v/fazah-arsenal?color=38bdf8&style=for-the-badge&logo=pypi)](https://pypi.org/project/fazah-arsenal/)
  7. [![Docker](https://img.shields.io/badge/Docker%20Hub-fazaharsenal-2496ed?style=for-the-badge&logo=docker)](https://hub.docker.com/r/fazaharsenal/github-ai-arsenal)
  8. [![Tools](https://img.shields.io/badge/GitHub%20Tools-20%2C078%2B-38bdf8?style=for-the-badge&logo=github)](https://github.com/fazah-arsenal/github-ai-arsenal)
  9. [![Live Site](https://img.shields.io/badge/Live%20Website-GitHub%20Pages-0ea5e9?style=for-the-badge)](https://fazah-arsenal.github.io/github-ai-arsenal/)
  10. [![MCP Server](https://img.shields.io/badge/Native%20MCP-19%20Tools%20%2B%20Prompts%20%2B%20Resources-8b5cf6?style=for-the-badge)](scripts/mcp_server.py)
  11. [![Dependencies](https://img.shields.io/badge/Python%20Deps-Zero%20(Stdlib%20Only)-22c55e?style=for-the-badge&logo=python)](scripts/gh_arsenal.py)
  12. [![CLI](https://img.shields.io/badge/Short%20CLI-fazah%20g%20%7C%20fazah%20ui-f59e0b?style=for-the-badge)](scripts/gh_arsenal.py)
  13. [![Registries](https://img.shields.io/badge/Smithery%20%26%20Glama-Ready-06b6d4?style=for-the-badge)](smithery.yaml)
  14. [![Author](https://img.shields.io/badge/Developer-FAZAH-f43f5e?style=for-the-badge)](https://t.me/testtttttttt11222)
  15. [![Telegram](https://img.shields.io/badge/Telegram-@testtttttttt11222-26A5E4?style=for-the-badge&logo=telegram)](https://t.me/testtttttttt11222)
  16. > **FAZAH AI Arsenal (`github-ai-arsenal`)** is a zero-dependency **Universal Agent Skill (`SKILL.md`)**, **12-Tool Native Model Context Protocol (`MCP`) Server**, and ultra-short **`fazah` CLI** that equips **Claude Code, Cursor, Google Antigravity, DeepSeek Harness, Windsurf, and OpenAI Codex** with instant offline & online access to **20,078+ real, deduplicated GitHub repositories** across 37 engineering domains.
  17. <img src="assets/hero-banner.svg" alt="FAZAH AI Arsenal Overview Card" width="100%"/>
  18. </div>
  19. ---
  20. ## πŸ‘¨β€πŸ’» Author & Official Contact
  21. | Field | Details |
  22. | :--- | :--- |
  23. | **Creator & Lead Developer** | **FAZAH** |
  24. | **Telegram** | [@testtttttttt11222](https://t.me/testtttttttt11222) |
  25. | **Email** | [mhamadabdalla150150@gmail.com](mailto:mhamadabdalla150150@gmail.com) |
  26. | **Official Repository** | [github.com/fazah-arsenal/github-ai-arsenal](https://github.com/fazah-arsenal/github-ai-arsenal) |
  27. ---
  28. ## 🌟 Why FAZAH AI Arsenal v6.5.1?
  29. Instead of letting your AI agent reinvent existing tools from scratch or burn through GitHub API rate limits, **FAZAH AI Arsenal** bundles a compressed offline index of **20,078+ real, battle-tested GitHub repositories** alongside a pure-Python **BM25 search engine**, **Repository Trust & Security Auditor**, **Side-by-Side Comparison Engine**, and **1-Command Project Stack Scaffolder** β€” with **zero external Python dependencies**.
  30. <div align="center">
  31. <img src="assets/architecture.svg" alt="FAZAH AI Arsenal Architecture" width="100%"/>
  32. </div>
  33. ### ✨ Key Capabilities:
  34. 1. **πŸ”Œ 19-Tool Native MCP Server (`scripts/mcp_server.py`)**: Plugs directly into Antigravity, Claude Code, Cursor, Windsurf, DeepSeek, OpenCode, and Codex via standard `stdio JSON-RPC 2.0` β€” zero `pip install` required.
  35. 2. **⚑ Instant Offline BM25 Search (`fazah m` & `fazah r`)**: Search **20,078+ real GitHub repositories** across 37 domains in milliseconds with zero API rate limits (supports both English & Arabic prompts).
  36. 3. **πŸ›‘οΈ Security & Trust Auditor (`fazah a` & `fazah cmp`)**: Computes a **Trust Score (0–100)** checking stars, maintenance recency, SPDX license, and repository hygiene β€” plus side-by-side repo comparisons.
  37. 4. **πŸ—οΈ 1-Command Project Scaffolder (`fazah st <stack> -s <dir>`)**: Generates ready-to-run starter projects from 8 turnkey blueprints (`saas-ai`, `telegram-ai-bot`, `scraping-rag`, `security-pentest-lab`, `reverse-engineering-lab`, `desktop-app`, `voice-ai-agent`, `mcp-builder`).
  38. 5. **πŸš€ Smart Quickstart (`fazah q`)**: Auto-detects any repository's ecosystem (Python, Node, Rust, Go, Docker) and outputs exact install/run commands.
  39. 6. **πŸ’‰ Auto MCP Injector (`fazah mi`)**: Safely injects any MCP server into `.mcp.json` with automatic `.bak` backup.
  40. 7. **⭐ Local Bookmarks (`fazah bm`)**: Save favorite repositories with custom notes for instant recall.
  41. 8. **πŸ“¦ Pull & Install Without Git (`fazah p` & `fazah is`)**: Download any GitHub repo ZIP or install any repo as a local `SKILL.md` without requiring `git`.
  42. ---
  43. ## 🎬 Video Walkthrough (Windows PC Live Screencast Demo)
  44. <div align="center">
  45. [![FAZAH AI Arsenal Windows 11 Screencast Walkthrough](https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/assets/demo_preview.gif)](https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/assets/demo_walkthrough.mp4)
  46. <p align="center">
  47. <a href="https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/assets/demo_walkthrough.mp4">
  48. <b>β–Ά Click here to view / download full MP4 video with Studio Audio (demo_walkthrough.mp4)</b>
  49. </a>
  50. </p>
  51. > **Full Windows PC Live Screencast Walkthrough** with studio English voiceover:
  52. > 1. **Windows 11 Desktop:** Launching Command Prompt directly from the desktop.
  53. > 2. **Setup in CMD:** Running `pip install fazah-arsenal` & `fazah link` (7 MCP clients auto-configured).
  54. > 3. **Google Antigravity IDE:** Launching Antigravity and opening the agent conversation pane.
  55. > 4. **Live Agent Dialogue:** Asking *"Is the FAZAH AI Arsenal tool linked to you?"* β€” Agent confirms connection & 19 active tools.
  56. > 5. **Autonomous Engineering:** Asking Antigravity to build an async web scraper with PostgreSQL β€” delivers verified code in 1 turn.
  57. > 6. **Token & Quota ROI:** Running `fazah savings` in CMD to review 640,000+ tokens and $3.80+ USD saved.
  58. </div>
  59. ---
  60. ## πŸ’» Interactive Terminal Console & Self-Loading Center (`fazah`)
  61. Simply run `fazah` or `fazah console` with no arguments to launch the **Interactive Terminal REPL**:
  62. ```bash
  63. # Launch the interactive console directly
  64. fazah
  65. # or
  66. python -m scripts.gh_arsenal console
  67. ```
  68. ```text
  69. β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•— β–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•—
  70. β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β•šβ•β•β–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘
  71. β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘ β–ˆβ–ˆβ–ˆβ•”β• β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘
  72. β–ˆβ–ˆβ•”β•β•β• β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ–ˆβ•”β• β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘
  73. β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘
  74. β•šβ•β• β•šβ•β• β•šβ•β•β•šβ•β•β•β•β•β•β•β•šβ•β• β•šβ•β•β•šβ•β• β•šβ•β•β•šβ•β•β•šβ•β• β•šβ•β•β•šβ•β•
  75. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  76. FAZAH AI ARSENAL v6.5.1 β€” Universal Autonomous Tool Broker
  77. 20,078 Real Tools Β· 19 Native MCP Tools Β· Zero-Dependency
  78. 🌐 Live Site : https://fazah-arsenal.github.io/github-ai-arsenal/
  79. πŸ’» Local UI : http://127.0.0.1:8765 (fazah ui)
  80. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  81. [*] INITIALIZING FAZAH AI ARSENAL SUBSYSTEMS...
  82. [==> ] 16% Checking Python Runtime & Environment ... [βœ“ Python 3.12]
  83. [=====> ] 33% Mounting BM25 Mega-Index (20,078 tools) ... [βœ“ 20,078 repos ready (3ms)]
  84. [=========> ] 50% Auditing MCP Client Registries ... [βœ“ 12 clients linked]
  85. [============> ] 66% Loading Adaptive Error Memory ... [βœ“ 3 learned reflexes]
  86. [===============> ] 83% Syncing Token & Quota Savings Ledger ... [βœ“ 786,000 tokens (~$4.69)]
  87. [===================>] 100% Checking GitHub API Authentication ... [βœ“ 5,000 req/hr (Active)]
  88. [βœ“] ALL SUBSYSTEMS OPERATIONAL & READY.
  89. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  90. β”‚ COMMAND PALETTE & QUICK ACTIONS β”‚
  91. β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
  92. β”‚ [1] πŸ” search <query> : Offline BM25 Search across 20,078 tools β”‚
  93. β”‚ [2] 🎯 rec <prompt> : Smart AI Recommender (Arabic & English) β”‚
  94. β”‚ [3] πŸ“¦ give <task> : 1-Call Autonomous Tool Broker (Pick & Deliver) β”‚
  95. β”‚ [4] πŸ›‘οΈ audit <repo> : Trust Score & Zero-Day Security Scan β”‚
  96. β”‚ [5] πŸ”— link : Zero-Touch MCP Auto-Link to 12 AI Clients β”‚
  97. β”‚ [6] πŸ”‘ token [key] : Set / Verify GitHub Personal Access Token β”‚
  98. β”‚ [7] πŸ› οΈ install-reqs : Audit & Install Runtimes / Fix Windows PATH β”‚
  99. β”‚ [8] βš™οΈ settings : Configure Default Paths, Limits & Auto-Link β”‚
  100. β”‚ [9] πŸ’° savings : Token & Cost Savings Ledger ($2.96+ Spared) β”‚
  101. β”‚ [10] 🧠 memory : Adaptive Error Memory & Learned Solutions β”‚
  102. β”‚ [11] πŸš€ stack <name> : 1-Click Project Blueprints (8 Turnkey Stacks) β”‚
  103. β”‚ [12] πŸ”„ update : Self-Update Arsenal & Mega-Index from GitHub β”‚
  104. β”‚ [13] 🌐 web / ui : Open Live Showcase & Local Web UI Dashboard β”‚
  105. β”‚ [0] πŸšͺ exit : Exit Console β”‚
  106. β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  107. πŸ’‘ Tip: Enter option number [1-13], command name, or type any task directly!
  108. fazah [644k saved]>
  109. ```
  110. ### 🌟 Console Quick Actions & Interactive Highlights
  111. - **`[6] πŸ”‘ token`**: Easily configure your GitHub Personal Access Token interactively. Tests connection live with GitHub API, unlocks 5,000 req/hr rate limits, saves to config, and persists to Windows User Environment (`setx GITHUB_TOKEN`).
  112. - **`[7] πŸ› οΈ install-reqs`**: Complete environment diagnostic. If `pip` is not recognized on Windows (missing from PATH), it **automatically detects the Python Scripts directory and fixes Windows PATH permanently** with zero manual intervention. Also audits Git, Docker, and MCP client paths.
  113. - **`[8] βš™οΈ settings`**: Interactively configure your default download folders, search limit sizes, automatic security scans, and auto-linking preferences.
  114. - **Natural Language Execution**: In the console, you don't even need to type command names β€” simply type your task directly in Arabic or English (e.g. `fastapi auth postgresql` or `أريد Ψ£Ψ―Ψ§Ψ© Ψͺفريغ ءوΨͺ`) and the AI agent automatically analyzes and recommends the top tools!
  115. ---
  116. ## πŸ–₯️ Live CLI Preview
  117. <div align="center">
  118. <img src="assets/cli-preview.svg" alt="FAZAH AI Arsenal CLI Preview" width="100%"/>
  119. </div>
  120. ---
  121. ## πŸ“‹ System Requirements & Prerequisites
  122. FAZAH AI Arsenal is built with a **Zero-Dependency & Offline-First** architecture. You only need standard Python to run the entire tool.
  123. | Component | Status | Requirement | Notes |
  124. | :--- | :---: | :--- | :--- |
  125. | **Python** | **REQUIRED** | Python 3.9, 3.10, 3.11, 3.12, or 3.13 | Standard Python installation (ensure added to PATH). |
  126. | **Disk & RAM** | **MINIMAL** | ~50 MB disk Β· <80 MB RAM | Entire 20k index is compressed in a 4.6 MB file and runs in memory. |
  127. | **Internet** | **OPTIONAL** | Only for initial `pip install` | 100% of searches, recommendations, and code delivery operate **offline**. |
  128. | **Git CLI** | **OPTIONAL** | Not required | If `git` is missing, FAZAH automatically downloads repositories via **HTTP ZIP Fallback**. |
  129. | **Docker** | **OPTIONAL** | Not required | Standalone native Python execution. Container image is provided as an alternative. |
  130. | **GitHub Token** | **OPTIONAL** | Zero rate limits offline | The offline index (20,078 tools) needs **no token**. A token is only needed if scanning live external repos >60 times/hour. |
  131. ### πŸ› οΈ Troubleshooting Windows PATH (`'pip' is not recognized`):
  132. If your terminal reports `'pip' is not recognized as an internal or external command`:
  133. 1. **Quick Fix (Run via python launcher):**
  134. ```cmd
  135. python -m pip install fazah-arsenal
  136. ```
  137. or:
  138. ```cmd
  139. py -m pip install fazah-arsenal
  140. ```
  141. 2. **Permanent Fix (Add Python & Scripts to Windows PATH):**
  142. Run this single command in **PowerShell**:
  143. ```powershell
  144. [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LOCALAPPDATA\Programs\Python\Python312;$env:LOCALAPPDATA\Programs\Python\Python312\Scripts", [EnvironmentVariableTarget]::User)
  145. ```
  146. 3. **Automated 1-Click Installer (Fixes PATH automatically):**
  147. ```powershell
  148. irm "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.ps1" | iex
  149. ```
  150. ---
  151. ## ⚑ 1-Command Installation
  152. ### 🐍 PyPI (Cross-Platform β€” Recommended)
  153. ```bash
  154. pip install fazah-arsenal
  155. ```
  156. *Or run any command immediately without installing via `uvx`:*
  157. ```bash
  158. uvx fazah-arsenal doctor
  159. ```
  160. ### 🐳 Docker (Instant Containerized MCP Server)
  161. ```bash
  162. docker run -i --rm fazaharsenal/github-ai-arsenal
  163. ```
  164. ### Windows (PowerShell Installer)
  165. ```powershell
  166. irm "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.ps1" | iex
  167. ```
  168. *(Or locally after downloading: `.\install.ps1`)*
  169. ### Linux / macOS
  170. ```bash
  171. curl -fsSL "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.sh" | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 218 on GitHub
  172. ```
  173. *(Or locally: `chmod +x install.sh && ./install.sh`)*
  174. ---
  175. ## πŸ”Œ Connect as a Native MCP Server
  176. Inject automatically into your workspace `.mcp.json`:
  177. ```bash
  178. fazah mi arsenal
  179. # Or use the full zero-touch auto-link command (injects into ALL clients at once):
  180. fazah link
  181. ```
  182. Or paste into your MCP client configuration (Antigravity, Claude Code, Cursor, Windsurf, DeepSeek):
  183. ```json
  184. {
  185. "mcpServers": {
  186. "fazah-arsenal": {
  187. "command": "fazah-mcp",
  188. "args": []
  189. }
  190. }
  191. }
  192. ```
  193. > **Tip:** `fazah link` auto-detects and updates Claude Desktop, Cursor, Windsurf, Antigravity, VS Code Cline, VS Code Roo, and your current workspace `.mcp.json` in a single command β€” zero manual editing required.
  194. ### 🧰 19 Native MCP Tools (+ 5 Resources & 3 Prompts) Exposed:
  195. | MCP Tool | Description |
  196. | :--- | :--- |
  197. | `arsenal_give_tool` | **1-Call Autonomous Tool Broker**: picks #1 tool, scans security, extracts code snippet & optionally pulls |
  198. | `arsenal_get_snippet` | Extracts clean runnable code snippets from any README (saves 85% AI tokens) |
  199. | `arsenal_deep_scan` | Deep supply-chain security scan of `setup.py`, `package.json`, `install.sh`, `Dockerfile` |
  200. | `arsenal_analyze_project` | Scans local project directory & recommends missing GitHub tools & MCP servers |
  201. | `arsenal_memory` | Persistent agent experience memory for verified working tools on this machine |
  202. | `arsenal_recommend` | Intelligent tool recommender (Core Elite + 20,078+ Mega Index) |
  203. | `arsenal_search_offline` | Instant offline BM25 search across 20,078+ repos with zero rate limits |
  204. | `arsenal_stack` | Browse 8 turnkey project stacks with install commands |
  205. | `arsenal_scaffold_stack` | Scaffold a complete starter project folder (`README.md`, `setup_stack`, `.env.example`, `.mcp.json`) |
  206. | `arsenal_quickstart` | Auto-detect language/ecosystem and output exact install & run commands |
  207. | `arsenal_compare` | Compare 2+ GitHub repositories side-by-side (Trust Score, Stars, License) |
  208. | `arsenal_audit_repo` | Security & Trust Score (0–100) audit before pulling or running code |
  209. | `arsenal_bookmark` | Add, list, or remove bookmarked favorite tools with notes |
  210. | `arsenal_mcp_inject` | Safely inject any MCP server into `.mcp.json` with backup |
  211. | `arsenal_inspect_repo` | Inspect repo metadata, top files, and `README.md`/`SKILL.md` without cloning |
  212. | `arsenal_pull_repo` | Download and extract any GitHub repository ZIP without `git` |
  213. | `arsenal_install_skill` | Auto-discover or synthesize `SKILL.md` and install any repo as a local skill |
  214. | `arsenal_learn` | **Teach FAZAH a failure**: record a broken package + error + fix so future calls auto-avoid it |
  215. | `arsenal_savings` | **Token & Quota Tracker**: exact tokens, USD, and API calls saved by using offline index + 1-call delivery |
  216. ---
  217. ## πŸ› οΈ Ultra-Short CLI Cheatsheet (`fazah`)
  218. ```bash
  219. fazah g "convert pdf to markdown" # 1-Call Autonomous Tool Broker (pick + scan + snippet)
  220. fazah g "web scraper" --pull # Pick, security-scan & auto-download ZIP in 1 call
  221. fazah sn unclecode/crawl4ai # Extract clean runnable code snippets (saves 85% tokens)
  222. fazah mem log unclecode/crawl4ai -t scrape # Log verified working tool into agent experience memory
  223. fazah try unclecode/crawl4ai # Pull into isolated Python venv sandbox safely
  224. fazah ui # Launch Interactive Local Web Dashboard (http://127.0.0.1:8765)
  225. fazah az . # Analyze current project & recommend missing tools/MCPs
  226. fazah scan unclecode/crawl4ai # Deep supply-chain security scan of setup.py/package.json
  227. fazah doc # Check local runtimes, skills & index health
  228. fazah info # Show breakdown of 20,078+ tools across 37 domains
  229. fazah r "telegram bot and web scraping" # Smart tool recommender (English & Arabic)
  230. fazah m -q "postgres vector" -n 10 # Instant offline BM25 search across 20k+ repos
  231. fazah q unclecode/crawl4ai # Auto-detect install & run commands
  232. fazah a modelcontextprotocol/servers # Security & Trust Score (0-100) audit
  233. fazah cmp unclecode/crawl4ai mendableai/firecrawl # Side-by-side repo comparison
  234. fazah st list # List all 8 turnkey project stacks
  235. fazah st saas-ai -s ./my-saas-app # Scaffold a complete starter project
  236. fazah bm add unclecode/crawl4ai -m "Best" # Bookmark a favorite repository
  237. fazah mi github-ai-arsenal # Auto-inject MCP server into .mcp.json
  238. fazah link # Zero-Touch: inject into ALL MCP clients at once
  239. fazah t -t mcp # Fetch live trending GitHub repos
  240. fazah s "deepseek coding agent" # Live GitHub API search
  241. fazah i danielmiessler/fabric # Inspect repo structure & README without cloning
  242. fazah p unclecode/crawl4ai -d ./tools # Download & extract repo ZIP without git
  243. fazah is anthropics/skills # Install any GitHub repo as a local SKILL.md
  244. fazah savings # View token & quota savings dashboard (tokens saved, USD, API calls avoided)
  245. fazah up # Self-update FAZAH AI Arsenal & 20k+ index from GitHub
  246. ```
  247. ### πŸ“¦ Install via Python `pip`
  248. ```bash
  249. pip install git+https://github.com/fazah-arsenal/github-ai-arsenal.git
  250. ```
  251. *(Full command names like `fazah recommend` and `python scripts/gh_arsenal.py recommend` also work identically.)*
  252. ---
  253. ## πŸ“Š Domain Coverage (20,078+ Real Indexed Repositories)
  254. | Domain | Indexed Tools | Highlights |
  255. | :--- | :---: | :--- |
  256. | `mcp-servers` | **5,032** | Official & community MCP servers for DBs, browsers, cloud, filesystems |
  257. | `go-systems` & `rust-systems` | **4,613** | High-performance systems, networking, CLI & infrastructure tools |
  258. | `devops-cloud` & `cpp-systems` | **2,289** | Docker, Kubernetes, CI/CD, cloud-native & low-level C/C++ libraries |
  259. | `machine-learning` & `ai-agents` & `ai-llm` | **1,452** | Multi-agent swarms, LLM routers, local inference, RAG & fine-tuning |
  260. | `ui-frontend` & `javascript-web` | **1,418** | React, Next.js, Tailwind, shadcn/ui & modern frontend ecosystems |
  261. | `media-audio-video` | **1,130** | Speech-to-Text (Whisper), TTS (Kokoro), video processing & FFmpeg tools |
  262. | `security-pentest` & `osint-recon` & `reverse-engineering` | **778** | SAST scanners, secret hunters, APK/ASAR/binary decompilers & OSINT |
  263. | `dotnet-csharp` / `python` / `java-jvm` / `php-web` / `mobile-desktop` / `blockchain-web3` | **2,650+** | Full-stack libraries, desktop GUIs, mobile apps, Web3 & game dev |
  264. ---
  265. ## πŸ§ͺ Running Automated Tests
  266. ```bash
  267. python -m unittest tests/test_arsenal.py
  268. ```
  269. **Current Test Suite: 14 tests, 100% passing.**
  270. | Test | Status |
  271. |:--|:--|
  272. | `test_stats_has_over_20000_tools` | βœ… PASS |
  273. | `test_doctor_command` | βœ… PASS |
  274. | `test_mega_offline_search_and_ranking` | βœ… PASS |
  275. | `test_recommend_arabic_and_english` | βœ… PASS |
  276. | `test_stack_command` | βœ… PASS |
  277. | `test_quickstart_and_bookmarks` | βœ… PASS |
  278. | `test_audit_repo_offline_fallback` | βœ… PASS |
  279. | `test_mcp_config_generator` | βœ… PASS |
  280. | `test_native_mcp_server_stdio` | βœ… PASS |
  281. | `test_give_snippet_and_memory` | βœ… PASS |
  282. | `test_analyze_project_and_deep_scan` | βœ… PASS |
  283. | `test_adaptive_error_learning_and_self_healing` | βœ… PASS |
  284. | `test_zero_touch_mcp_auto_link` | βœ… PASS |
  285. | `test_quota_and_token_savings_tracker` | βœ… PASS |
  286. ---
  287. ## πŸ“ž Connect With the Developer
  288. * **Author**: **FAZAH**
  289. * **Telegram**: [@testtttttttt11222](https://t.me/testtttttttt11222)
  290. * **Email**: `mhamadabdalla150150@gmail.com`
  291. ---
  292. ## πŸ“„ License
  293. Released under the **MIT License** β€” free for personal, open-source, and commercial AI workflows.
.mcp.json Β· Bundled script Β· 12 lines Β· 1 finding marked
  1. {
  2. "mcpServers": {
  3. "fazah-arsenal": {
  4. "command": "C:/Users/Compumarts/AppData/Local/Programs/Python/Python312/Scripts/fazah-mcp.EXE",
    • Warning: Contains a long base64-looking blob β€” not necessarily malicious, but worth inspecting what it decodes to
    • Line 4 on GitHub
  5. "args": []
  6. },
  7. "github-ai-arsenal": {
  8. "command": "C:/Users/Compumarts/AppData/Local/Programs/Python/Python312/Scripts/fazah-mcp.EXE",
  9. "args": []
  10. }
  11. }
  12. }
install.ps1 Β· Bundled script Β· 66 lines Β· 1 finding marked
  1. # DeepSeek Harness / Universal Agents Skill Installer (Windows PowerShell)
  2. # Supports both local execution (.\install.ps1) and 1-liner remote execution via `irm ... | iex`
    • Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
    • Line 2 on GitHub
  3. $ErrorActionPreference = "Stop"
  4. $SkillName = "github-ai-arsenal"
  5. $LocalScript = $MyInvocation.MyCommand.Path
  6. $SourceDir = if ($LocalScript) { Split-Path -Parent $LocalScript } else { "" }
  7. $TempExtract = ""
  8. if (-not $SourceDir -or -not (Test-Path (Join-Path $SourceDir "SKILL.md"))) {
  9. $Repo = if ($env:GH_ARSENAL_REPO) { $env:GH_ARSENAL_REPO } else { "fazah-arsenal/github-ai-arsenal" }
  10. $Branch = if ($env:GH_ARSENAL_BRANCH) { $env:GH_ARSENAL_BRANCH } else { "main" }
  11. $ZipUrl = "https://github.com/$Repo/archive/refs/heads/$Branch.zip"
  12. $TempZip = Join-Path $env:TEMP "$SkillName-install.zip"
  13. $TempExtract = Join-Path $env:TEMP "$SkillName-extract"
  14. if (Test-Path $TempExtract) { Remove-Item $TempExtract -Recurse -Force }
  15. Write-Host "Downloading $SkillName from $ZipUrl ..." -ForegroundColor Cyan
  16. Invoke-WebRequest -Uri $ZipUrl -OutFile $TempZip -UseBasicParsing
  17. Expand-Archive -Path $TempZip -DestinationPath $TempExtract -Force
  18. Remove-Item $TempZip -Force -ErrorAction SilentlyContinue
  19. $Sub = Get-ChildItem $TempExtract -Directory | Select-Object -First 1
  20. $SourceDir = $Sub.FullName
  21. }
  22. $Targets = @(
  23. (Join-Path $env:USERPROFILE ".agents\skills\$SkillName"),
  24. (Join-Path $env:USERPROFILE ".gemini\config\skills\$SkillName")
  25. )
  26. foreach ($extra in @(".claude\skills", ".codex\skills", ".cursor\skills")) {
  27. $root = Join-Path $env:USERPROFILE $extra
  28. if (Test-Path $root) { $Targets += (Join-Path $root $SkillName) }
  29. }
  30. foreach ($dest in $Targets) {
  31. Write-Host "Installing $SkillName -> $dest" -ForegroundColor Cyan
  32. if (Test-Path $dest) { Remove-Item $dest -Recurse -Force }
  33. New-Item -ItemType Directory -Path $dest -Force | Out-Null
  34. Copy-Item (Join-Path $SourceDir "SKILL.md") -Destination $dest -Force
  35. Copy-Item (Join-Path $SourceDir "README.md") -Destination $dest -Force
  36. Copy-Item (Join-Path $SourceDir "scripts") -Destination (Join-Path $dest "scripts") -Recurse -Force
  37. Copy-Item (Join-Path $SourceDir "references") -Destination (Join-Path $dest "references") -Recurse -Force
  38. if (Test-Path (Join-Path $SourceDir "examples")) {
  39. Copy-Item (Join-Path $SourceDir "examples") -Destination (Join-Path $dest "examples") -Recurse -Force
  40. }
  41. }
  42. if ($TempExtract -and (Test-Path $TempExtract)) {
  43. Remove-Item $TempExtract -Recurse -Force -ErrorAction SilentlyContinue
  44. }
  45. # Install short global CLI command: `fazah`
  46. $BinDir = Join-Path $env:USERPROFILE ".local\bin"
  47. New-Item -ItemType Directory -Path $BinDir -Force | Out-Null
  48. $FazahCmd = Join-Path $BinDir "fazah.cmd"
  49. $MainScript = Join-Path $env:USERPROFILE ".agents\skills\$SkillName\scripts\gh_arsenal.py"
  50. "@echo off`r`npython `"$MainScript`" %*" | Set-Content -Path $FazahCmd -Encoding ASCII
  51. $UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
  52. if (-not $UserPath -or ($UserPath -notlike "*$BinDir*")) {
  53. $NewPath = if ($UserPath) { "$UserPath;$BinDir" } else { $BinDir }
  54. [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
  55. $env:Path = "$env:Path;$BinDir"
  56. }
  57. Write-Host "Installed $SkillName (20,078+ GitHub tools, Native MCP Server & short 'fazah' CLI) successfully!" -ForegroundColor Green
  58. Write-Host "Try now: fazah doc | fazah r `"telegram bot`" | fazah m -q `"postgres`"" -ForegroundColor Yellow

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.