supercli CLI
A CLI launcher for agents: it finds a command among skills, runs it and returns one JSON envelope with clear exit codes.
- 57 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Through the launcher an agent runs arbitrary CLIs, registry plugins and HTTP calls.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/supercliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Through the launcher an agent runs arbitrary CLIs, registry plugins and HTTP calls.
This is third-party code. Review the repository files before installing.
What it does
supercli reduces different interfaces to one shape: regular CLIs, APIs, MCP servers and workflows. An agent finds a capability with `npx supercli skills search "deploy"`, reads its arguments through `skills get` and runs it, receiving structured JSON. For humans there is a `--human` flag. `supercli ask` combines several tools into one answer, and plugins install from a registry with `plugins install`. The project has three implementations sharing plugin storage at `~/.supercli/plugins/plugins.lock.json`. The Zig build starts fastest, the Machin build weighs about 71 KB and embeds an MCP server, and the Node.js build installs through npm and has the full feature set including an MCP client and an HTTP adapter.
Who it is for. Agent and script developers who need one way to discover and call different tools with predictable output.
Good fit when
- An agent does not know which commands exist and must first find one and read its arguments.
- The output of different tools must be normalised into JSON with shared exit codes.
- You need an MCP server as one small binary with no Node.js: the Machin build provides it.
- Plugins are needed with a shared registry and a lock file of versions.
Not a fit when
- Direct calls to a few familiar commands are enough for you.
- Installing plugins from a registry of outside authors is not acceptable.
- You need guarantees about the number and quality of available tools: the README states it in a marketing tone.
Example request
Use supercli to find a CloudFormation deploy tool, show its arguments and run it with my stack name.Limitations
Three implementations coexist and their feature sets differ: full parity is claimed for the Node.js build. Names diverge: `npx supercli` and `npm install -g superacli` use different package names, so check the README before installing. The Zig and Machin installers run through `curl` and `bash` from GitHub releases and should be read before running. Through supercli an agent can run any CLI, plugin and HTTP call, so constrain it in your environment: connect only needed sources and review plugins before installing.
How to disable. Uninstall the global package with `npm uninstall -g superacli`, delete the Zig or Machin binaries and the `~/.supercli` directory with the plugin lock file.
FAQ
How do I try it without installing?
Run `npx supercli help` or `npx supercli skills search "github"`. The package is fetched on first call.
How do I get readable output?
Add the `--human` flag; by default supercli prints JSON.
How do I see a capability's arguments?
Use `npx supercli inspect http check health` or `npx supercli skills get <name>`.
How do I run the MCP server?
In the Machin build run `sc-machin mcp serve` to expose the commands to agents over MCP.
How do I work with plugins?
Use `npx supercli plugins list`, `plugins explore` and `plugins install <name>`.
Discussion
No questions or reviews yet.
Related
CLI toolsA plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub
Hycli turns a website URL and a goal into a typed CLI and MCP tools that run in your own browser session, with no cookie leaks.
A language and runtime for skills an agent writes and a human approves: execution through allowlisted connectors and signatures
An MCP server and CLI for the BOSS job platform: search vacancies, filter by conditions and shortlist with JSON output
SwitchBot smart-home CLI for devices and scenes, with a built-in MCP server for Claude Code, Codex and Gemini CLI.
A self-hosted control plane for running several agents: task dispatch, run review, spend tracking, connected via MCP, CLI or REST
README in short
The README presents the project as a universal launcher for any CLI with JSON by default, and describes capability sources, the response envelope with exit codes and operating modes. The repository also holds an agent skills catalogue.