feat: `sc run <plugin> <action>` — one-shot discover+install+execute

[javimosch]

Problem

Promoting SuperCLI on social media needs a tweetable one-liner. Currently, discovering and running a plugin for the first time requires 3 chained commands:

npx superacli plugins update && npx superacli plugins install claude-session-optimizer && npx superacli claude-session-optimizer self auto

Thats ~240 characters — too long for a tweet, and too verbose for a first-time user to remember.

Desired UX

# one-shot: updates catalog, installs plugin, runs the action
npx superacli run claude-session-optimizer self auto

# even shorter alias
npx scrun claude-session-optimizer self auto

A single run (or go, x, !) command that:

1. plugins update — syncs the latest plugin catalog from GitHub master (so new plugins are discoverable even on stale npm releases)
2. plugins install <plugin> — registers the plugin commands if not already installed (idempotent — no-op if already installed)
3. Executes the requested <resource> <action> with given args

Requirements

• Idempotent: if plugin is already installed and catalog is current, skip steps 1-2 and just execute
• Fast path: if local catalog is fresh (e.g., <1h old), skip the update fetch
• Works with npx: must not require global install — npx superacli run <plugin> <action> should be the entry point
• Error handling: if plugin not found even after update, show clear error with available plugins

Example

# Tweetable one-liner for claude-session-optimizer
npx superacli run claude-session-optimizer self auto

# Works for any plugin
npx superacli run github-mcp self mcp
npx superacli run a2a-skill project init

Why This Matters

A 240-char shell pipeline wont fit in a tweet, wont get retweeted, and wont convert casual users. A single run command at ~80 chars will.

Real use case: promoting claude-session-optimizer — see https://github.com/javimosch/claude-session-optimizer

[javimosch]

Problem

Promoting SuperCLI on social media needs a tweetable one-liner. Currently, discovering and running a plugin for the first time requires 3 chained commands:

npx superacli plugins update && npx superacli plugins install claude-session-optimizer && npx superacli claude-session-optimizer self auto

That is ~240 characters — too long for a tweet, and too verbose for a first-time user to remember.

Desired UX

# one-shot: updates catalog, installs plugin, runs the action
npx superacli run claude-session-optimizer self auto

A single run (or go, x, !) command that:

1. plugins update — syncs the latest plugin catalog from GitHub master
2. plugins install — registers the plugin if not already installed (idempotent)
3. Executes the requested resource action with given args

Requirements

• Idempotent: if plugin already installed and catalog fresh, skip steps 1-2
• Fast path: if local catalog is fresh (<1h old), skip the update fetch
• Works with npx: must not require global install
• Error handling: if plugin not found even after update, show clear error

Example

# Tweetable one-liner for claude-session-optimizer
npx superacli run claude-session-optimizer self auto

# Works for any plugin
npx superacli run github-mcp self mcp
npx superacli run a2a-skill project init

Why This Matters

A 240-char shell pipeline wont fit in a tweet, wont get retweeted, and wont convert casual users. A single run command at ~80 chars will.

Real use case: promoting claude-session-optimizer — see https://github.com/javimosch/claude-session-optimizer

[javimosch]

npx resolution behavior (important!)

Tested and confirmed:

Command	Fresh machine	Has superacli installed
npx sc	❌ Would install sc@1.0.1 (Sauce Labs)	✅ Found on PATH
npx supercli	❌ Would install supercli@0.4.1 (colored messages lib)	✅ Found on PATH
npx superacli	✅ Downloads our superacli package	✅ Found on PATH

So npx superacli is the only safe entry point for first-time users. The run command should be documented as:

npx superacli run claude-session-optimizer self auto

Optional enhancement: once run exists, we could publish a tiny @superacli/run or similar meta-package if we really want npx scrun — but thats over-engineering for now.

[javimosch]

✅ Implemented in #master (a32b718)

Added sc run <plugin> <resource> <action> — one-shot command that:

1. Syncs plugin catalog from GitHub (plugins update)
2. Installs the plugin if not already installed (plugins install)
3. Executes the requested action

Tweetable one-liner (Claude Session Optimizer):

npx superacli run claude-session-optimizer self auto

Works for any plugin:

npx superacli run github-mcp self mcp
npx superacli run a2a-skill project init

Smoke tested:

• Fresh plugin (not installed): auto-detected, installed, executed ✓
• Already installed: skipped install, fast execution ✓
• Invalid plugin: clear error message ✓
• Missing resource/action: usage help ✓

Files:

• cli/run.js (new) — command implementation
• cli/supercli.js — dispatch handler added