![\"Stars\"](\"https://img.shields.io/github/stars/javimosch/supercli?style=social&label=Stars\")
\n ![\"npm\"](\"https://img.shields.io/npm/v/superacli\")
\n ![\"Latest](\"https://img.shields.io/badge/release-2026--06--08-blue\"){kind=icon}
\n ![\"License\"](\"https://img.shields.io/badge/license-MIT-green\"){kind=icon}
\n ![\"Plugins\"](\"https://img.shields.io/badge/plugins-10k+-blueviolet\"){kind=icon}
\n\n
The universal launcher for every CLI tool — no installs, JSON-first, one command.
\n\n\n Zero install. Run any CLI tool with npx supercli.
\n JSON-first by default. Use --human for readable output.\n
\n ⭐ Like supercli? Star it on GitHub — one click, makes a huge difference.\n
\n\n> **10,000 tools. One command. Zero friction.**\n\n## ⚡ TL;DR\n\n> Turn any CLI, API, or workflow into a discoverable, executable capability\n> — with consistent inputs, outputs, and zero glue code.\n\n```bash\n# Discover what exists (JSON by default)\nnpx supercli skills search \"deploy\"\n\n# Understand exactly how to use it\nnpx supercli skills get aws.cfn.deploy\n\n# Execute with predictable output (JSON by default)\nnpx supercli aws cfn deploy --stack-name my-stack\n\n# For human-readable output, add --human\nnpx supercli aws cfn deploy --stack-name my-stack --human\n```\n\n👉 Works the same across CLI tools, APIs, MCP servers, and workflows\n👉 No glue code, no parsing, no guesswork\n\n## Table of Contents\n\n- [Quick Start](#-quick-start)\n- [For Humans](#for-humans)\n- [For AI Agents](#for-ai-agents)\n- [What You Get](#what-you-get)\n- [CLI Usage Examples](#️-cli-usage-examples)\n- [Architecture](#️-architecture)\n- [Capability Sources](#-capability-sources)\n- [Output Envelope + Exit Codes](#-output-envelope--exit-codes)\n- [Operating Modes](#️-operating-modes)\n- [Install](#-install)\n- [Troubleshooting](#️-troubleshooting)\n- [Tech Stack](#️-tech-stack)\n- [Community & Social](#️-community--social)\n\n## ⚡ Example\n\n```bash\nnpx supercli ask \"list my tasks and recent commits\"\n```\n\n```json\n{\n \"tasks\": [...],\n \"commits\": [...]\n}\n```\n\n→ Combines multiple tools into one structured response.\n\n## The Problem\n\nEvery tool speaks a different language:\n- CLIs → flags & inconsistent output\n- APIs → schemas & auth\n- MCP/tools → custom protocols\n- Workflows → glue code everywhere\n\nHumans waste time learning syntax. Agents fail because nothing is predictable.\n\nWithout supercli, integrating a new tool means:\n1. Finding and reading its documentation\n2. Learning its flag syntax and output format\n3. Writing glue code to parse and transform the output\n4. Handling edge cases and error states manually\n5. Repeating for every additional tool\n\n**For agents**, the situation is worse — every tool responds differently, errors are unstructured, and there's no way to discover capabilities dynamically.\n\n## The Solution\n\nsupercli turns everything into capabilities:\n- Same structure → `supercli![\"Support](\"https://storage.ko-fi.com/cdn/brandasset/v2/support_me_on_kofi_badge_beige.png\"){kind=icon}
\n![\"Support](\"https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white\"){kind=icon}
\n\n---\n\n## License\n\nMIT — Javier Leandro Arancibia\n","readmeFilename":"README.md"}