{"id":29097376,"url":"https://github.com/prathushan/wp-site-inspector-agent","last_synced_at":"2025-06-28T13:42:02.615Z","repository":{"id":293505551,"uuid":"984260314","full_name":"prathushan/WP-Site-Inspector-Agent","owner":"prathushan","description":"Your WordPress debug \u0026 discovery co-pilot. Instantly uncover shortcodes, hooks, templates, REST APIs, and logs — with AI-powered code analysis, XLSX export, and smart error fixing. Just ask, and let AI suggest the fix. Built for devs, freelancers \u0026 agencies.","archived":false,"fork":false,"pushed_at":"2025-06-26T08:11:45.000Z","size":2059,"stargazers_count":28,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-26T09:20:50.838Z","etag":null,"topics":["code-mapping","custom-post-types","debugging","developer-tools","hook-inspector","php","plugin-development","shortcode","site-audit","theme-audit","theme-debugger","theme-development","wordpres-development","wordpress","wordpress-hooks","wordpress-plugin","wordpress-tools","wp-cli"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prathushan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-GPLv2.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-15T16:35:35.000Z","updated_at":"2025-06-26T08:11:48.000Z","dependencies_parsed_at":"2025-05-15T17:48:34.427Z","dependency_job_id":"7cd208d2-ba1f-445c-8924-0409a7bba33d","html_url":"https://github.com/prathushan/WP-Site-Inspector-Agent","commit_stats":null,"previous_names":["prathushan/wp-site-inspector","prathushan/wp-site-inspector-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/prathushan/WP-Site-Inspector-Agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prathushan%2FWP-Site-Inspector-Agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prathushan%2FWP-Site-Inspector-Agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prathushan%2FWP-Site-Inspector-Agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prathushan%2FWP-Site-Inspector-Agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prathushan","download_url":"https://codeload.github.com/prathushan/WP-Site-Inspector-Agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prathushan%2FWP-Site-Inspector-Agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262439407,"owners_count":23311338,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-mapping","custom-post-types","debugging","developer-tools","hook-inspector","php","plugin-development","shortcode","site-audit","theme-audit","theme-debugger","theme-development","wordpres-development","wordpress","wordpress-hooks","wordpress-plugin","wordpress-tools","wp-cli"],"created_at":"2025-06-28T13:42:01.828Z","updated_at":"2025-06-28T13:42:02.609Z","avatar_url":"https://github.com/prathushan.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e🛠️ WP Site Inspector Agent\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eYour WordPress Debug \u0026 Discovery Co-Pilot\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eAudit themes, plugins, REST APIs, and fix errors with AI — in seconds.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/prathushan/WP-Site-Inspector?tab=MIT-2-ov-file#\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/prathushan/WP-Site-Inspector/releases\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-v1.0.0-blue?style=flat-square\" alt=\"Manual Version Badge\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/prathushan/WP-Site-Inspector/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/prathushan/WP-Site-Inspector?color=orange\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/prathushan/WP-Site-Inspector/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/prathushan/WP-Site-Inspector?color=red\" alt=\"GitHub Issues\"\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/WordPress-Tested-blue?logo=wordpress\" alt=\"WordPress Tested\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 📖 Overview\n\n**WP Site Inspector Agent** is an open-source WordPress plugin built for developers, freelancers, and agencies who need **instant, actionable insights** into any WordPress site.\n\nIt’s like an x-ray machine for your WordPress stack — exposing everything from shortcodes and hooks to REST APIs, templates, and hidden issues.\n\n\u003e ⚡ No more digging through theme files.  \n\u003e 🧠 No more guessing where bugs live.\n\n---\n\n## ✨ Features\n\n\u003cimg src=\"./assets/Wp-site-inspector-ui.png\" alt=\"WP Site Inspector UI\" align=\"right\" width=\"350\"\u003e\n\n- ✅ Scan active/parent themes without setup  \n- ✅ Instantly list shortcodes, hooks, templates, post types  \n- ✅ Detect REST API calls, CDN links \u0026 JS usage  \n- ✅ View file paths \u0026 line numbers  \n- ✅ List all published pages, posts \u0026 custom post types  \n- ✅ Export reports to `.xls`  \n- ✅ Admin-only access with secure design  \n- ✅ Fatal error detection + alert emails  \n- ✅ Built-in AI chatbot for log analysis (BYOK)  \n- ✅ AI-powered log auto-fix  \n- ✅ Multilingual UI: 🇬🇧 English, 🇩🇪 German, 🇪🇸 Spanish  \n\n\n---\n\n## 🚀 Why Use It?\n\nIf you've ever said:\n\n- “What’s even happening on this site?”  \n- “Where is this shortcode defined?”  \n- “Which plugin is breaking the homepage?”  \n\nThen **WP Site Inspector Agent** is made for you.\n\nPerfect for:  \n🧑‍💻 Freelancers • 🧪 QA Engineers • 🏢 Agencies • 💡 WP Contributors • 👩‍🎓 Students\n\n---\n\n## 🔍 Use Cases\n\n- 🧩 Auditing undocumented themes \u0026 templates  \n- 🛠️ Debugging custom features  \n- 🔄 Refactoring legacy code  \n- 🤝 Creating handoff-ready documentation  \n- 📋 Generating a technical site map  \n\n---\n\n## 🤖 AI Code Assistant\n\n\u003cimg src=\"./assets/Ask ai.png\" alt=\"Ask AI Screenshot\" align=\"right\" width=\"350\"\u003e\n\n\u003e AI chatbot that finds, explains, and fixes errors.\n\n✔️ Ask: “Why did this error happen?”  \n✔️ Suggest fixes for deprecated or fatal code  \n✔️ Get file-level insights on PHP warnings or notices  \n✔️ Understand complex or undocumented functions  \n✔️ Get explanations for deprecation notices and warnings  \n✔️ Identify which plugin/theme generated the error  \n✔️ Copy fix suggestions directly into your theme/plugin  \n✔️ Use your own API key (BYOK) for private debugging  \n\n\n---\n\n### ⚡ AI-powered log auto-fix\n\n\u003cimg src=\"./assets/WP_Site_Inspector _Agen_Workflow.png\" alt=\"AI Fix Flow\" align=\"right\" width=\"190\" style=\"margin-left:20px;\"\u003e\n\n**Automatically detect and fix errors directly from logs.**\n\n- Parses your logs for **file names** and **line numbers**  \n- Opens affected files and **auto-fixes** issues with LLMs  \n- Takes an automatic backup (`.bak`) of the file  \n- If anything goes wrong, **auto-restores the original** version  \n- Compatible with all major WordPress themes and plugins  \n- Handles common errors like undefined variables, missing includes, deprecated functions  \n- Displays status updates: Pending, Fulfilled, Failed  \n- Works with custom-coded themes and plugins  \n- Designed for both novice and advanced developers  \n\n\u003e Powered by your preferred model: OpenAI, Claude, Gemini, DeepSeek, or OpenRouter — via your own API key (BYOK)\n\n**Example Query:**  \n`\"Undefined variable $undefined_variable (File: /code/wp-content/themes/twentytwentyfive/functions.php Line: 164)\"`\n\n\n---\n\n## 🔐 BYOK (Bring Your Own Key) Support\n\nWP Site Inspector Agent gives you full control over AI usage. In the plugin settings, you can add your own API key and choose from supported providers and models.\n\n**Supported Providers \u0026 Models:**\n\n\u003cdiv align=\"center\"\u003e\n\n| Provider     | Models |\n|--------------|--------|\n| `wp-site-inspector` | `WPSI-01` |\n| `openai`     | `gpt-4`, `gpt-3.5-turbo` |\n| `deepseek`   | `deepseek-chat`, `deepseek-coder`, `deepseek-chat-v3` |\n| `anthropic`  | `Claude 3 Opus`, `Claude 3 Sonnet`, `Claude 3 Haiku` |\n| `google`     | `Gemini 1.5 Pro`, `Gemini 1.0 Pro` |\n| `mistral`    | `Mistral Small`, `Mistral Medium`, `Mistral Large` |\n| `openrouter` | `GPT-3.5 Turbo`, `GPT-4`, `DeepSeek Chat v3 (Free)` |\n\n\u003c/div\u003e\n\n---\n\n### 🆓 Don’t have a key? Use Our Free Model!\n\nYou can also use our own hosted model: **WPSI-01**, available under the `wp-site-inspector` provider.\n\n\u003e ✅ We offer limited free access per day.  \n\u003e 📧 Just send a request via email to get your personal API key.  \n\u003e 🔐 Secure, no vendor lock-in, and completely private.\n\n---\n\n\n## 🌍 Multilingual Support\n\n- 🇬🇧 English  \n- 🇩🇪 German  \n- 🇪🇸 Spanish  \n\nUI auto-detects and adapts to your site's language.\n\n---\n\n## 📤 One-Click Export\n\nExport your full scan to `.xlsx` — perfect for:\n\n- 🧪 QA reports  \n- 🧾 Client documentation  \n- 🔧 Dev handoffs  \n\n---\n\n## 📦 Coming Soon\n \n- 🧪 WP-CLI integration  \n\n\n---\n\n## ⚙️ Installation\n\n1. [Download latest ZIP](https://github.com/prathushan/WP-Site-Inspector/archive/refs/heads/main.zip)  \n2. Go to **Plugins → Add New → Upload Plugin**  \n3. Install and activate  \n4. Start inspecting from the WP Admin menu  \n\n---\n\n## 💡 Why We Built This\n\nBecause:\n\n- WordPress sites grow messy — fast  \n- Developers waste hours asking “What’s active and why?”  \n- Legacy code makes debugging painful  \n\n\u003e This plugin saves time, simplifies audits, and improves team handoffs.\n\n---\n\n## 📬 Contact\n\n- 📧 Email: [prathusha.nammi@gmail.com](mailto:prathusha.nammi@gmail.com)  \n- 🐛 Bug reports: [GitHub Issues](https://github.com/prathushan/WP-Site-Inspector/issues)  \n- 💡 Feature requests: [GitHub Discussions](https://github.com/prathushan/WP-Site-Inspector/discussions)  \n\n---\n\n## 🙌 Authors\n\nMade with ❤️ by:\n\n- [**Prathusha**](https://github.com/prathushan)  \n- [**Prem Kumar**](https://github.com/PremKumar-Softscripts)  \n- [**Vinay**](https://github.com/v-i-nay)  \n\nWant to contribute? 👉 [Open a Pull Request](https://github.com/prathushan/WP-Site-Inspector/pulls)\n\n⭐️ If you find this project helpful, please consider [starring the repo](https://github.com/prathushan/WP-Site-Inspector) — it helps others discover it too!\n\n\n---\n\n\n## 📄 License\n\nDistributed under the [MIT License](https://choosealicense.com/licenses/mit/).  \nFree to use, modify, and distribute with attribution.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAudit. Analyze. Fix. Repeat.\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eBuilt for WordPress developers who demand clarity and control.\u003c/em\u003e\n\u003c/p\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprathushan%2Fwp-site-inspector-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprathushan%2Fwp-site-inspector-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprathushan%2Fwp-site-inspector-agent/lists"}