diff --git a/EXAMPLES_STATUS.md b/EXAMPLES_STATUS.md
new file mode 100644
index 0000000..d2210e6
--- /dev/null
+++ b/EXAMPLES_STATUS.md
@@ -0,0 +1,70 @@
+# Examples Status
+
+Hey there! 👋 This file exists so contributors and users can quickly see which examples are working, which are untested, and which might need some love.
+
+> Last updated: May 2026
+> Maintained by the community — if you test something, please update this file!
+
+## Legend
+| Symbol | Meaning |
+|--------|---------|
+| ✅ | Tested and working |
+| ⚠️ | Not tested yet |
+| ❌ | Broken |
+| 🔧 | Needs fixing |
+
+---
+
+## Status Table
+
+| Example | Last Tested | Python Version | Status | Notes |
+|---------|-------------|----------------|--------|-------|
+| fetch-hackathon-quickstarter | — | — | ⚠️ Untested | Great starting point! |
+| anthropic-quickstart | — | — | ⚠️ Untested | Claude integration series |
+| gemini-quickstart | — | — | ⚠️ Untested | Google Gemini series |
+| asi1-llm-example | — | — | ⚠️ Untested | ASI:One + LangChain |
+| openai-agent-sdk | — | — | ⚠️ Untested | OpenAI Agents SDK |
+| Claude Agent SDK | — | — | ⚠️ Untested | Real estate search agent |
+| Crewai-agents | — | — | ⚠️ Untested | CrewAI multi-agent collection |
+| ag2-agents | — | — | ⚠️ Untested | AG2 framework examples |
+| Rag-agent | — | — | ⚠️ Untested | RAG with vector search |
+| llama-index | — | — | ⚠️ Untested | LlamaIndex RAG + Stripe |
+| mcp-agents | — | — | ⚠️ Untested | MCP server agents |
+| a2a-cart-store | — | — | ⚠️ Untested | A2A shopping cart + Skyfire |
+| a2a-uAgents-Integration | — | — | ⚠️ Untested | A2A communication examples |
+| launch-your-a2a-agent | — | — | ⚠️ Untested | Quick A2A agent launcher |
+| launch-your-a2a-research-team | — | — | ⚠️ Untested | Multi-agent research team |
+| stripe-payment-agents | — | — | ⚠️ Untested | Stripe API may have changed |
+| stripe-horoscope-agent | — | — | ⚠️ Untested | Horoscope + Stripe payments |
+| image-agent-payment-protocol | — | — | ⚠️ Untested | Image gen + payment protocol |
+| fet-example | — | — | ⚠️ Untested | FET payment + image gen |
+| Composio | — | — | ⚠️ Untested | Gmail + LinkedIn automation |
+| Browser-based-agents | — | — | ⚠️ Untested | Browser automation agents |
+| frontend-integration | — | — | ⚠️ Untested | Next.js + uAgents |
+| advance-agent-examples | — | — | ⚠️ Untested | Advanced agent patterns |
+| community_agent | — | — | ⚠️ Untested | AI community growth agent |
+| google-genai-parallel-processing | — | — | ⚠️ Untested | Parallel processing GenAI |
+| flight-tracker-openai-workflow-agent | — | — | ⚠️ Untested | Flight tracking agent |
+| asi-cloud-agent | — | — | ⚠️ Untested | ASI Cloud deployment |
+| av-script-example | — | — | ⚠️ Untested | Agentverse script deployment |
+| deploy-agent-on-av | — | — | ⚠️ Untested | Deploy agents via Render |
+| pdf-summariser-example | — | — | ⚠️ Untested | PDF summarization agent |
+| duffel-agent | — | — | ⚠️ Untested | Flight booking + payments |
+| web3 | — | — | ⚠️ Untested | Web3 integrations |
+| openclaw | — | — | ⚠️ Untested | Connector + orchestrator |
+| cursor-rules | — | — | ⚠️ Untested | Cursor IDE rules |
+| google-adk | — | — | ⚠️ Untested | Google ADK examples |
+| video-to-map-agent | — | — | ⚠️ Untested | Video to map agent |
+
+---
+
+## How to contribute to this file 🙌
+
+Tested an example? Awesome! Just update its row:
+
+1. Fork the repo
+2. Update the row with the date, Python version, and status
+3. Add any helpful notes (errors you hit, API keys needed, etc.)
+4. Raise a PR — even a one-row update helps!
+
+Every little update makes life easier for the next person. Thanks for helping out!