Run without installing anything

npx supercli uuid self generate

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

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.

---

📦 Install

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

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

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

⚡ Quick Start

```bash

🛠️ Examples

```bash

→ [{"file":"config.js","line":42,"type":"AWS Access Key"}]

```

---

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

Option 1: Zig Version (Fast, Single Binary)

```bash

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

```bash

Progressive Adoption

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

```bash

📦 3,300+ CLI Tools — Organized

---

Zig version shows: SuperCLI (Zig) v0.1.0

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 ```

→ {"version":"1.0","mode":"agent_bootstrap","workflow":"discover -> inspect -> execute",...}

Discover plugins

sc-zig plugins explore --name memory --json

→ {"total":19,"returned":19,"plugins":[...]}

🔄 Keeping Plugins Updated

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

```bash

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.

---