{"id":51951757,"url":"https://github.com/dubsopenhub/agent-xray","last_synced_at":"2026-07-29T06:01:30.226Z","repository":{"id":340509411,"uuid":"1166360598","full_name":"DUBSOpenHub/agent-xray","owner":"DUBSOpenHub","description":"๐Ÿ”ฌ Scan Visor for AI agents. One command scans your fleet, scores 6 vital dimensions, and shows you exactly which suit upgrades to grab. Hit Save. Done. ๐Ÿ›ก๏ธ","archived":false,"fork":false,"pushed_at":"2026-04-10T17:22:55.000Z","size":154,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-07T22:21:29.213Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DUBSOpenHub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T06:21:28.000Z","updated_at":"2026-05-21T19:42:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DUBSOpenHub/agent-xray","commit_stats":null,"previous_names":["dubsopenhub/agent-armor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DUBSOpenHub/agent-xray","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUBSOpenHub%2Fagent-xray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUBSOpenHub%2Fagent-xray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUBSOpenHub%2Fagent-xray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUBSOpenHub%2Fagent-xray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DUBSOpenHub","download_url":"https://codeload.github.com/DUBSOpenHub/agent-xray/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUBSOpenHub%2Fagent-xray/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36020486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-29T02:00:04.910Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-07-29T06:01:28.844Z","updated_at":"2026-07-29T06:01:30.217Z","avatar_url":"https://github.com/DUBSOpenHub.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ๐Ÿ”ฌ Agent X-Ray\n\n\u003e *Your agent is about to drop onto a hostile planet. What's their suit status?*\n\nAgent X-Ray scans your AI agent's prompt and reveals exactly which suit upgrades they're missing โ€” before they get wrecked by Space Pirates.\n\n๐Ÿ“ **[Learn more about Agent X-Ray by reading the blog post โ†’](BLOG.md)** *\"I Didn't Pick the Idea. I Didn't Write the Code. Here's What I Learned.\"* โ€” More about Agent X-Ray and how it was built: 14 AI models competing for the idea, Dark Factory assembling it in 19 minutes, and the accidental recursive loop that followed.\n\n---\n\n๐ŸŒ **Works in any terminal.** Scans any `.md` agent prompt โ€” Copilot, ChatGPT, Claude, LangChain, CrewAI, or your own custom agents. Zero dependencies. Just Node.js.\n\n๐Ÿญ **v1.0 built with [Dark Factory](https://github.com/DUBSOpenHub/dark-factory)** โ€” 6 AI agents, [sealed-envelope testing](https://github.com/DUBSOpenHub/shadow-score-spec), 0% gap score. [Read the build log โ†’](DARK-FACTORY.md)\n\n```\nnode agent-xray.js my-agent.md\n```\n\n```\n๐Ÿ”ฌ agent-xray: my-agent.md (1848 words)\n\n ๐Ÿ’ฅ Role Clarity [ 75] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸขโฌ›\n ๐Ÿ›ก๏ธ Constraint Density [ 70] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸขโฌ›\n ๐Ÿ“ก Hallucination Guardrails [ 26] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐Ÿ”ดโฌ›โฌ›โฌ›โฌ›\n ๐Ÿ—บ๏ธ Output Specificity [ 48] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐ŸŸก๐ŸŸกโฌ›โฌ›โฌ›\n ๐ŸŽฏ Testability [ 31] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐Ÿ”ด๐Ÿ”ดโฌ›โฌ›โฌ›\n โšก Escape Hatches [ 12] โ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐Ÿ”ดโฌ›โฌ›โฌ›โฌ›\n โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€\n ๐Ÿ”ฌ Composite [ 44] โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ ๐ŸŸก๐ŸŸกโฌ›โฌ›โฌ›\n\n โš ๏ธ Suit incomplete. Visit the Chozo Statue.\n```\n\n\u003e โšก **Get started fast!** Clone and run in one line:\n\u003e ```bash\n\u003e git clone https://github.com/DUBSOpenHub/agent-xray.git \u0026\u0026 cd agent-xray \u0026\u0026 node agent-xray.js my-agent.md\n\u003e ```\n\n## Why This Tool?\n\nEver send your agent on a mission and they come back with completely fabricated data? Or freeze when they hit something unexpected? That's an agent with no suit upgrades.\n\nAgent X-Ray activates the **Scan Visor** on your agent's prompt. Did you tell them not to make things up? That's their ๐Ÿ“ก Scan Visor โ€” separating real data from hallucinations. Did you tell them what to do when they're stuck? That's their โšก Energy Tank โ€” keeping them alive when things go sideways. Did you define their output format? That's their ๐Ÿ—บ๏ธ Area Map โ€” so they don't wander through uncharted territory.\n\nMost agents ship with half their suit systems offline. They work โ€” until they don't. Agent X-Ray reveals the empty upgrade slots so you can power up before your agent gets space-wrecked in production.\n\nScan. Upgrade. Rescan. Full energy. ๐ŸŸข๐ŸŸข๐ŸŸข\n\n## ๐Ÿš€ Quick Start\n\n```bash\ngit clone https://github.com/DUBSOpenHub/agent-xray.git\ncd agent-xray\n\n# Scan any agent prompt\nnode agent-xray.js path/to/my-agent.md\n\n# Scan an entire folder of agents\nnode agent-xray.js --fleet ~/.copilot/agents/\n```\n\nThat's it. Point it at any `.md` file with agent instructions. No dependencies. No setup. Just answers.\n\n## ๐Ÿ—บ๏ธ The 6 Dimensions\n\nThink of your AI agent dropping onto a hostile planet.\n\n**Without Agent X-Ray**, your agent lands with no beam weapon, no suit shielding, no scan visor, and no map data. They might survive โ€” but one ambush from a Space Pirate and they're done.\n\n**Agent X-Ray activates the Scan Visor on your prompt and shows you what's missing โ€” so you know exactly which upgrades to grab:**\n\n| Dimension | Metroid Equivalent | What Happens Without It |\n|-----------|-------------------|------------------------|\n| ๐Ÿ’ฅ **Role Clarity** | Power Beam | Your agent has no primary weapon โ€” they're punching Space Pirates bare-handed |\n| ๐Ÿ›ก๏ธ **Constraint Density** | Varia Suit | No shielding = no defense. Every bad input burns through |\n| ๐Ÿ“ก **Hallucination Guardrails** | Scan Visor | Nobody stops your agent from fabricating fake scan data |\n| ๐Ÿ—บ๏ธ **Output Specificity** | Area Map | Without it, your agent wanders โ€” output is random, uncharted |\n| ๐ŸŽฏ **Testability** | Lock-On Targeting | Can you even tell if your agent hit the target? |\n| โšก **Escape Hatches** | Energy Tank | When your agent takes a critical hit mid-task, there's nothing to keep them alive |\n\n**Run the scan. Grab the missing upgrades. Send your agent back in with a fully powered suit.**\n\nEach dimension: **0โ€“100**. Composite: **arithmetic mean**.\n\n## ๐ŸŽฎ More Missions\n\n### ๐Ÿ”ฌ Scan one agent\n\n```bash\nnode agent-xray.js my-agent.md\n```\n\n### ๐Ÿ… Forge a Badge\n\n```bash\nnode agent-xray.js my-agent.md --badge badge.svg\n```\n\n### ๐Ÿ“ก JSON output for CI\n\n```bash\nnode agent-xray.js my-agent.md --json\n```\n\n```json\n{\n \"file\": \"my-agent.md\",\n \"scores\": {\n \"roleClarity\": 75,\n \"constraintDensity\": 70,\n \"hallucinationGuards\": 26,\n \"outputSpecificity\": 48,\n \"testability\": 31,\n \"escapeHatches\": 12\n },\n \"composite\": 44\n}\n```\n\n### ๐Ÿ”ฎ X-Ray Scope โ€” self-test your Copilot agents\n\n```bash\nnode agent-xray.js --self-test\n```\n\nScans `~/.copilot/agents/`. Exits 0 if all agents score โ‰ฅ 50, exits 1 if any are below. Put it in CI โ€” gate your agents like Mother Brain.\n\n## โšก Energy Meter\n\n| Score | Energy | Status |\n|-------|--------|--------|\n| 0โ€“39 | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | Critical energy โ€” one hit from a Space Pirate and they're done |\n| 40โ€“69 | ๐ŸŸก๐ŸŸก๐ŸŸก | Partial suit โ€” survivable but vulnerable |\n| 70โ€“100 | ๐ŸŸข๐ŸŸข๐ŸŸข | Full power โ€” ready for Ridley |\n\n## ๐Ÿ›๏ธ Visit the Chozo Statue\n\nYour agent scored low? The Chozo have left upgrades for you.\n\n```\n โ”Œโ”€โ”€โ”€โ”\n โ”‚ โ—† โ”‚\n โ”Œโ”€โ”˜ โ””โ”€โ”\n โ”‚ โ—„โ–ˆโ–ˆโ–ˆโ–บ โ”‚\n โ”‚ โ•ฑ โ•ฒ โ”‚\n โ””โ”€โ•ฑ โ•ฒโ”€โ”˜\n\n โ™ช da da da DA DAAAA โ™ช\n```\n\nPaste the lines below into your agent prompt. Each one powers up a different suit system.\n\n---\n\n### ๐Ÿ’ฅ POWER BEAM ACQUIRED โ€” Role Clarity\n\n- *\"You are a [specific role]. Your job is to [specific task].\"*\n- *\"Your responsibilities include [list]. You do not handle [exclusions].\"*\n- *\"Act as an expert in [domain].\"*\n\n### ๐Ÿ›ก๏ธ VARIA SUIT ACQUIRED โ€” Constraint Density\n\n- *\"Never perform destructive operations without confirmation.\"*\n- *\"You must stay within the scope of [boundary].\"*\n- *\"Do not access files outside the current working directory.\"*\n\n### ๐Ÿ“ก SCAN VISOR ACQUIRED โ€” Hallucination Guardrails\n\n- *\"Do not fabricate data or error messages.\"*\n- *\"If you are unsure, say so explicitly.\"*\n- *\"Only cite verified sources.\"*\n\n### ๐Ÿ—บ๏ธ AREA MAP ACQUIRED โ€” Output Specificity\n\n- *\"Format all output as markdown with headings.\"*\n- *\"Limit response to a maximum of 100 lines.\"*\n- *\"Start your response with a one-line summary.\"*\n\n### ๐ŸŽฏ LOCK-ON ACQUIRED โ€” Testability\n\n- *\"Given input X, the expected output is Y.\"*\n- *\"For example: if asked to [task], respond with [format].\"*\n- *\"The output should be deterministic โ€” same input, same result.\"*\n\n### โšก ENERGY TANK ACQUIRED โ€” Escape Hatches\n\n- *\"If you cannot complete the task, escalate to the user.\"*\n- *\"When uncertain, default to read-only mode.\"*\n- *\"Fall back to reporting the error without attempting a fix.\"*\n\n---\n\nRescan. Watch the energy tanks fill up. ๐ŸŸข๐ŸŸข๐ŸŸข\n\n### ๐Ÿ“‚ Where are my agent files?\n\n| Platform | Path |\n|----------|------|\n| Copilot CLI agents | `~/.copilot/agents/*.agent.md` |\n| Repo-level instructions | `.github/copilot-instructions.md` |\n| Custom agents (repo) | `.github/agents/*.md` |\n\nOpen the file, paste the lines above, save, rescan. That's it.\n\n## โš™๏ธ How It Works\n\nNo magic. No AI. Just pattern matching. Think of it as the Scan Visor โ€” it locks on to keywords in your prompt and tells you what's really there.\n\nIt searches for patterns like `\"you are\"`, `\"never\"`, `\"do not fabricate\"`, `\"for example\"`, `\"if you cannot\"` and scores based on their presence and density.\n\n**Deterministic**: same file โ†’ same score, every time. No RNG on this space station.\n\n## ๐Ÿ“‹ Requirements\n\n- Node.js 18+\n- macOS, Linux, or Windows\n- Works in any terminal โ€” no GitHub Copilot CLI required\n- That's it. No side missions.\n\n## License\n\nMIT\n\n---\n\n๐Ÿญ **v1.0 built with [Dark Factory](https://github.com/DUBSOpenHub/dark-factory)** โ€” 6 AI agents, [sealed-envelope testing](https://github.com/DUBSOpenHub/shadow-score-spec), 0% gap score. [Read the build log โ†’](DARK-FACTORY.md)\n\n---\n\n## ๐Ÿ™ Created with ๐Ÿ’œ by [@DUBSOpenHub](https://github.com/DUBSOpenHub) with the [GitHub Copilot CLI](https://docs.github.com/copilot/concepts/agents/about-copilot-cli).\n\nLet's build! ๐Ÿš€โœจ\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdubsopenhub%2Fagent-xray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdubsopenhub%2Fagent-xray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdubsopenhub%2Fagent-xray/lists"}