| name | supercli.quickstart |
| description | SuperCLI capability router — discover and execute CLI commands through namespace.resource.action interface |
| tags | supercli,cli,plugin,capability,discovery,agent |
SuperCLI Quickstart
SuperCLI is a deterministic capability router that wraps external CLIs behind a unified namespace.resource.action interface.
Key Concept
Instead of running raw commands, use:
supercli <namespace> <resource> <action> [--flags]
Agent Rules (CLI-first discovery)
Never search the filesystem (plugins/, grep, glob) to find plugins or
commands. Use the CLI itself — it has built-in filters:
supercli --json
supercli plugins explore --name <query>
supercli plugins learn <plugin-name>
supercli discover --intent "<task>"
supercli commands --query <keyword> --limit 50 --json
Workflow
- discover: Find plugins/commands for an intent
- learn: Read usage documentation
- inspect: View command schema and flags
- plan: Preview execution steps
- execute: Run the command
supercli skills
Skill documents provide agent-facing guidance in SKILL.md format. Use supercli skills to discover and fetch skill documentation.
supercli skills list
supercli skills get <namespace.resource.action>
supercli skills teach
supercli skills search --query <text>
supercli skills sync
supercli skills providers list
supercli skills providers add --name <provider> --roots <path>
supercli skills providers remove --name <provider>
supercli plugins
Plugins extend supercli with additional command capabilities.
supercli plugins explore
supercli plugins learn <plugin-name>
supercli plugins install <plugin-name>
supercli plugins install --git <repo-url> --manifest-path <path>
supercli plugins list
supercli plugins show <plugin-name>
supercli plugins doctor <plugin-name>
Important Flags
| Flag | Purpose |
|---|
--json | Machine-readable output |
--human | Formatted output for humans |
--non-interactive | Fail fast (for agents) |
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 82 | Validation error (missing args) |
| 85 | Invalid argument |
| 92 | Resource not found |
| 105 | Integration error |
| 110 | Internal error |