supercli ⎯ 3,300+ CLI Tools, One Command — and growing every day

Zero install. Run any CLI tool with npx supercli.
Works for humans. Works for AI agents. Everything returns JSON.

Quick Start →   |   Examples →   |   For AI Agents →

---

The problem: Every CLI tool has different flags, different output formats, different install methods. You waste time learning syntax instead of getting work done. AI agents can't use most tools because output is unpredictable.

supercli fixes this. 3,300+ tools. One interface. JSON out. Zero guesswork.

---

⚡ Quick Start

# Run without installing anything
npx supercli uuid self generate
# → {"uuid":"550e8400-e29b-41d4-a716-446655440000"}

# Check if a website is up
npx supercli http check health --url https://example.com
# → {"status":"ok","ms":142,"code":200}

# Generate a password
npx supercli passgen
# → {"password":"xK9#mP2$vL7@nQ5%"}

# Convert CSV to JSON
echo "name,age\nAlice,30\nBob,25" | npx supercli csv json convert
# → [{"name":"Alice","age":"30"},{"name":"Bob","age":"25"}]

# AI mode — describe what you want
npx supercli ask "generate a uuid and check if google.com is up"
# → Combines multiple tools automatically

💡 No install? Correct. npx supercli works immediately.
Want it global? npm install -g superacli

---

🚀 What Makes This Different

Instead of...	You do...
Installing 50 tools separately	One command: npx supercli
Reading man pages for flags	supercli skills get <tool>.* → structured metadata
Parsing inconsistent output	--json on every tool
Gluing tools with shell scripts	supercli ask "do X and Y"
Teaching agents tool syntax	JSON envelopes, machine-readable errors

---

🛠️ Examples

# ---- EVERYDAY TOOLS ----

# Get weather for any city
npx supercli weather now "Tokyo"
# → {"temp_C":22,"condition":"Clear","humidity":65}

# Get system info as JSON
npx supercli sys info
# → {"host":"my-server","cpus":8,"mem":"32GB","uptime":"14d"}

# Encode/decode base64
npx supercli base64 encode "hello world"
npx supercli base64 decode "aGVsbG8gd29ybGQ="

# Format a JSON file
cat data.json | npx supercli json validate
cat data.json | npx supercli json pick "users.*.name"

# Check SSL certificate details
npx supercli cert info --domain github.com
# → {"issuer":"GTS","expires":"2026-07-22","days_left":74}

# ---- AI & DATA ----

# Count tokens in text (LLM context planning)
echo "Your prompt text here" | npx supercli token count
# → {"chars":142,"words":24,"tokens_estimate":32}

# Profile a CSV file
npx supercli data profile data.csv
# → {"columns":5,"rows":1000,"types":{"age":"numeric","name":"string"}}

# Scan for secrets in code
npx supercli secret scan ./src
# → [{"file":"config.js","line":42,"type":"AWS Access Key"}]

---

🤖 For AI Agents

supercli was designed for agents from day one.

# Every tool returns the same envelope
{
  "version": "1.0",
  "command": "http.check.health",
  "duration_ms": 142,
  "data": { "status": "ok" }
}

Why agents love supercli:

• 🔍 Discoverable — supercli skills search "database" returns machine-readable metadata
• 📦 Deterministic — Every tool accepts --json, --silent (no interactive prompts)
• 🚨 Predictable errors — Standard error codes: 82 (validation), 105 (integration), 110 (internal)
• 🔗 Composable — supercli ask "check status and send alert" chains tools automatically
• 📋 Auditable — Every call logs namespace, resource, action, inputs, outputs

# Agent workflow: discover → inspect → execute
supercli skills search "deploy" --json
supercli skills get aws.cfn.deploy --json
supercli aws cfn deploy --stack my-stack --json

⚡ Zig Implementation (sc-zig)

For maximum performance and minimal dependencies, use the Zig implementation:

# Install single binary (~260KB, no Node.js required)
curl -sL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/install.sh | bash

# Or manual install
curl -sL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/sc-zig-linux-amd64 -o ~/.local/bin/sc-zig && chmod +x ~/.local/bin/sc-zig

# Agent-friendly bootstrap
sc-zig --json
# → {"version":"1.0","mode":"agent_bootstrap","workflow":"discover -> inspect -> execute",...}

# Discover plugins
sc-zig plugins explore --name memory --json
# → {"total":19,"returned":19,"plugins":[...]}

# Install plugins (delegates to Node.js sc when needed)
sc-zig plugins install agentmemory-cli

Why agents prefer sc-zig:

• ⚡ Single binary — No Node.js runtime, just curl + chmod
• 🚀 Faster — Native performance, instant startup
• 📦 Self-documenting — Bootstrap JSON includes workflow guidance
• 🔧 Agent guidance — Suggests plugins update when catalog is empty
• 🎯 Fixed arg parsing — Both --flag value and --flag=value work
• 📍 Positional args — Correctly handles positional arguments

See AGENTS.md for complete agent instructions.

---

🔄 Keeping Plugins Updated

Plugins are added daily — new tools, updated checksums, fresh metadata. Keep your local installation in sync:

# Check what's new (dry-run, no changes)
supercli plugins update --check

# Apply the latest plugins
supercli plugins update

Latest npm release: v1.15.0 (2026-05-14) — published [8 days ago]. New versions ship multiple times per week.

---

📦 3,300+ CLI Tools — Organized

Category	Count	Examples
System	450+	curl, jq, git, tmux, htop, rsync
Development	380+	cargo, npm, go, rustc, gcc, make
Databases	120+	mysql, postgres, redis, mongodb, sqlite, cockroach
Cloud	160+	aws, gcloud, azure, kubectl, terraform, pulumi
Security	200+	nmap, gitleaks, trufflehog, openssl, git-crypt
Network	180+	ncat, tshark, mtr, socat, chisel, doggo
Data	150+	csvkit, xsv, miller, qsv, datamash
Media	100+	ffmpeg, sox, imagemagick, exiftool, gstreamer
Testing	90+	k6, vegeta, fortio, hey, siege, wrk2
Blockchain	30+	foundry, cast, hardhat, truffle, solana
Serverless	40+	fission, openfaas, kn, serverless, chalice
Web	80+	wrangler, netlify, vercel, surge, heroku

Every tool includes: description, tags, source URL, install method, binary check, and commands.

---

📦 Install

Option 1: Zig Version (Fast, Single Binary)

# Quick install (curl)
curl -sSL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/install.sh | bash

# Install and replace Node.js version
curl -sSL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/install.sh | bash -s -- --replace

Why Zig?

• ✅ No Node.js startup overhead
• ✅ Single static binary (250KB)
• ✅ Reads same ~/.supercli/plugins/plugins.lock.json
• ✅ Progressive adoption: co-exists with Node.js version
• ✅ Easy revert: npm uninstall -g supercli && npm install -g supercli

Option 2: Node.js Version (npx/npm)

# Run immediately (no install)
npx supercli uuid self generate

# Install globally
npm install -g superacli
supercli uuid self generate

Why Node.js?

• ✅ Full feature parity (MCP, server, HTTP adapter)
• ✅ Plugin installation from registry
• ✅ Ecosystem integration

Progressive Adoption

Both versions read the same plugin storage. Try the Zig version first:

# Install Zig version as sc-zig (co-exists with Node.js sc)
curl -sSL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/install.sh | bash

# Test it
sc-zig --version

# If you like it, replace Node.js sc:
sc-zig install-as-sc
sudo ln -sf /usr/local/bin/sc-zig /usr/local/bin/sc

# To go back to Node.js:
npm uninstall -g supercli
npm install -g supercli

Check which version you have:

sc --version
# Zig version shows: SuperCLI (Zig) v0.1.0
# Node.js version shows different info

---

💬 What People Say

"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)

⭐ If supercli saved you time, star the repo. Takes one click, means the world to us.

---

License

MIT — Javier Leandro Arancibia