Think: "Stripe API for CLIs and tools"
Standardized inputs, outputs, and execution for everything.

Turn any CLI, API, or workflow into a discoverable, executable capability — with consistent inputs, outputs, and zero glue code.

# 1. Discover capabilities
npx supercli skills search "deploy" --json

# 2. Inspect it
npx supercli skills get aws.cfn.deploy --json

# 3. Execute with predictable output
npx supercli aws cfn deploy --stack-name my-stack --json

👉 Works the same across CLI tools, APIs, MCP servers, and workflows 👉 No glue code, no parsing, no guesswork

npx supercli ask "list my tasks and recent commits"

{
  "tasks": [...],
  "commits": [...]
}

→ Combines multiple tools into one structured response (multi-tool execution).

Every tool speaks a different language:

• CLIs → flags & inconsistent output
• APIs → schemas & auth
• MCP/tools → custom protocols
• Workflows → glue code everywhere

Humans waste time learning syntax. Agents fail because nothing is predictable.

supercli turns everything into capabilities:

• Same structure → supercli <namespace> <resource> <action>
• Same output → deterministic JSON envelopes
• Same discovery → searchable skill graph
• Same execution → no custom integrations

# Explore capabilities
npx supercli skills list
npx supercli skills search "github"

# Run real commands
npx supercli beads issue list --json
npx supercli gh issue list --json

# AI-driven execution
npx supercli ask "show my tasks and recent commits"

# Manage plugins
npx supercli plugins list
npx supercli plugins explore
npx supercli plugins install commiat

# Agent mode
npx supercli --help-json
npx supercli skills get <capability> --json

Install globally: npm install -g superacli for repeated use. Server mode: See docs/features/server-plugins.md

Stop juggling CLI tools with different syntax and outputs. supercli gives you one consistent interface to AWS, GitHub, Docker, Kubernetes, and more—so you stop learning syntax and start executing faster.

Agents don't guess—they query, inspect, and execute. Access a standardized skill graph where every capability follows predictable input/output envelopes. Discover, compose, and execute workflows with machine-readable metadata that enables reliable automation.

• Explicit Boundaries: Each skill declares capabilities, inputs, outputs—nothing hidden
• Consistent Wrappers: --json, --silent modes prevent interactive prompts
• Audit Trail: Every invocation logs plugin, action, inputs, and outputs
• Opt-In Power: Full CLI access requires explicit passthrough
• Predictable Errors: Standardized error envelopes with machine-readable codes

• 🔍 Find any capability instantly — no docs hunting
• ⚡ Run tools with one consistent interface
• 🤖 Give agents predictable, structured execution
• 🔗 Combine multiple tools without glue code
• 📦 Extend anything via plugins

# --- Discovery ---
npx supercli skills list
npx supercli skills search "database"

# --- Inspection (for agents) ---
npx supercli inspect beads issue create
npx supercli skills get beads.issue.create --json

# --- Execution ---
npx supercli beads issue create --title "Fix bug"
npx supercli beads issue list --json
npx supercli gwc drive files list

# --- AI ---
npx supercli ask "do X and Y"

# --- Plugins ---
npx supercli plugins list
npx supercli plugins install commiat
npx supercli plugins show commiat

See docs/plugin-harness-guide.md for creating your own harnesses.

The supercli router:

• Discovers capabilities from every adapter, caches metadata for instant lookup
• Routes commands to correct harness based on namespace
• Executes with unified error handling, envelopes, and output formatting
• Surfaces machine-readable descriptions so agents can plan against the capability graph

supercli replaces tool-specific syntax with a queryable, executable capability graph.

supercli generates capabilities from multiple sources:

• Bundled Harnesses – beads, gwc (Google Workspace), commiat
• Built-in Adapters – OpenAPI specs, HTTP, MCP servers
• Plugin Harnesses – CLIs installed via supercli plugins install
• AI & Plans – natural-language ask commands create execution DAGs

Every command returns a deterministic envelope:

{
  "version": "1.0",
  "command": "namespace.resource.action",
  "duration_ms": 42,
  "data": { ... }
}

supercli sync only relevant when SUPERCLI_SERVER is configured. See docs/features/server-plugins.md.

• NodeJS + Express
• Pluggable KV Storage (Local JSON files by default, MongoDB optional)
• Vue3 + Tailwind + DaisyUI
• Zero build tools
• Plugin system for registering new harnesses

Early users (including agent builders):

"Yooooooo, my agent nearly shit himself when I showed him this. TY! I'll keep an eye out for updates from you. This is a fantastic tool!" — zetsi77 (@Hadu_Ken77)

Contributions welcome! See CONTRIBUTING.md for guidelines.

MIT License - Copyright (c) 2026 Javier Leandro Arancibia

See LICENSE file for details.