🚀 Introducing VUDA — Visual UI Debug Agent

Sami Halawa

samihalawa

Follow

Have you ever been stuck debugging a web app where buttons don’t respond, flows break, or interactions silently fail? Tired of guessing what went wrong?

Meet VUDA – Visual UI Debug Agent. A fully automated MCP (Modular Control Program) that sees your interface, clicks through your flows, and fixes common UI issues — all with zero manual inspection.

⸻

🔍 What VUDA Does • Detects broken or unresponsive UI elements • Highlights interactive zones visually • Checks for layout errors and flow inconsistencies • Modifies code automatically (e.g., app.py, main.js, etc.) • Revalidates the flow after patching — like a real debugging agent

It doesn’t just tell you what’s wrong — it fixes it. You get before/after UI screenshots, action logs, and patch suggestions — all automatically grounded to the actual interface.

⸻

🛠️ How to Use It

You can install and run VUDA instantly using Smithery:

npx -y @smithery/cli@latest install @samihalawa/visual-ui-debug-agent-mcp --client cursor

VUDA was tested in Cursor, but works with any Smithery-compatible interface. It’s lightweight, visual, and designed to feel like you’re pair-programming with an intelligent UI tester.

⸻

🧠 Why I Built It

I was debugging the same kinds of UI bugs over and over: broken buttons, misaligned flows, UI components that failed silently. VUDA is the result of turning that pain into an autonomous agent that helps anyone debug visually, contextually, and intelligently.

⸻

💬 Try It Out

You can explore VUDA, contribute, or give feedback right here on Hugging Face.

This is just the beginning — future versions will support: • Multiple browser environments • AI-generated fix suggestions • Workflow chaining with other MCPs

⸻

🔗 Let’s build better interfaces — visually, automatically. VUDA is free, open, and now live. Install it. Break it. Help me improve it. 🙌

— @samihalawa