superacli 1.1.26 → 1.1.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superacli",
-  "version": "1.1.26",
+  "version": "1.1.27",
   "description": "Config-driven, AI-friendly dynamic CLI",
   "license": "MIT",
   "main": "server/app.js",

package/plugin-quality-report.json

@@ -0,0 +1,568 @@
+{
+  "timestamp": "2026-05-08T15:49:17.329Z",
+  "totalPlugins": 1179,
+  "pluginsNeedingFixes": 142,
+  "summary": {
+    "shortDescription": 105,
+    "genericSource": 86,
+    "minimalTags": 121
+  },
+  "suggestions": [
+    {
+      "name": "actix",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"actix\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/actix/actix"
+      }
+    },
+    {
+      "name": "agency-agents",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "agent-browser",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "ascii-image-converter",
+      "issues": [
+        "Very short description (< 30 chars)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"Convert images into ASCII art\" - Consider expanding with purpose/features"
+      }
+    },
+    {
+      "name": "ash",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"ash\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/ash/ash"
+      }
+    },
+    {
+      "name": "atuin",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"atuin\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/atuin/atuin"
+      }
+    },
+    {
+      "name": "aws",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"AWS CLI plugin for dcli\" - Consider expanding with purpose/features",
+        "additionalTags": [
+          "cloud"
+        ]
+      }
+    },
+    {
+      "name": "aws-cli",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"aws-cli\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/aws-cli/aws-cli",
+        "additionalTags": [
+          "cloud"
+        ]
+      }
+    },
+    {
+      "name": "aws-doctor",
+      "issues": [
+        "Generic or missing source URL"
+      ],
+      "suggestions": {
+        "sourceUrl": "https://github.com/aws-doctor/aws-doctor"
+      }
+    },
+    {
+      "name": "az",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"Azure CLI plugin for dcli\" - Consider expanding with purpose/features",
+        "additionalTags": [
+          "cloud"
+        ]
+      }
+    },
+    {
+      "name": "azd",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {
+        "additionalTags": [
+          "cloud",
+          "development"
+        ]
+      }
+    },
+    {
+      "name": "azure-cli",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"azure-cli\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/azure-cli/azure-cli",
+        "additionalTags": [
+          "cloud"
+        ]
+      }
+    },
+    {
+      "name": "bash",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"bash\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/bash/bash",
+        "additionalTags": [
+          "shell"
+        ]
+      }
+    },
+    {
+      "name": "blogwatcher",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "broot",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"broot utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/broot/broot"
+      }
+    },
+    {
+      "name": "browser-use",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "additionalTags": [
+          "web"
+        ]
+      }
+    },
+    {
+      "name": "bump",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"bump utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/bump/bump"
+      }
+    },
+    {
+      "name": "cargo-clap",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-clap\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-clap/cargo-clap"
+      }
+    },
+    {
+      "name": "cargo-edit",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-edit\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-edit/cargo-edit"
+      }
+    },
+    {
+      "name": "cargo-generate",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-generate utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-generate/cargo-generate"
+      }
+    },
+    {
+      "name": "cargo-generate-new",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-generate-new\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-generate-new/cargo-generate-new"
+      }
+    },
+    {
+      "name": "cargo-tree",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-tree utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-tree/cargo-tree"
+      }
+    },
+    {
+      "name": "cargo-watch",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"cargo-watch utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/cargo-watch/cargo-watch"
+      }
+    },
+    {
+      "name": "cass",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "clap",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"clap\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/clap/clap"
+      }
+    },
+    {
+      "name": "clawteam",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "cline",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {
+        "additionalTags": [
+          "productivity"
+        ]
+      }
+    },
+    {
+      "name": "clix",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "cocoindex-code",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "additionalTags": [
+          "web"
+        ]
+      }
+    },
+    {
+      "name": "commiat",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "consul",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"consul\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/consul/consul"
+      }
+    },
+    {
+      "name": "copilot",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    },
+    {
+      "name": "criterion",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"criterion\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/criterion/criterion"
+      }
+    },
+    {
+      "name": "criterion-rs",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"criterion-rs\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/criterion-rs/criterion-rs"
+      }
+    },
+    {
+      "name": "dash",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"dash\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/dash/dash"
+      }
+    },
+    {
+      "name": "dcos-cli",
+      "issues": [
+        "Very short description (< 30 chars)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"The command line for DC/OS\" - Consider expanding with purpose/features"
+      }
+    },
+    {
+      "name": "delta",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"delta utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/delta/delta"
+      }
+    },
+    {
+      "name": "derive-args",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"derive-args\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/derive-args/derive-args"
+      }
+    },
+    {
+      "name": "digitalocean-cli",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"digitalocean-cli\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/digitalocean-cli/digitalocean-cli"
+      }
+    },
+    {
+      "name": "docker",
+      "issues": [
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "additionalTags": [
+          "data",
+          "devops"
+        ]
+      }
+    },
+    {
+      "name": "docopt",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"docopt\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/docopt/docopt"
+      }
+    },
+    {
+      "name": "doctl",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"doctl\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/doctl/doctl"
+      }
+    },
+    {
+      "name": "elvish",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"elvish\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/elvish/elvish"
+      }
+    },
+    {
+      "name": "exa",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"exa utility\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/exa/exa"
+      }
+    },
+    {
+      "name": "eza",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"eza CLI plugin for dcli\" - Consider expanding with purpose/features"
+      }
+    },
+    {
+      "name": "fd-find2",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"fd-find2\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/fd-find2/fd-find2"
+      }
+    },
+    {
+      "name": "fish",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"fish\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/fish/fish"
+      }
+    },
+    {
+      "name": "fzf-bin",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"fzf-bin\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/fzf-bin/fzf-bin"
+      }
+    },
+    {
+      "name": "gcloud-sdk",
+      "issues": [
+        "Very short description (< 30 chars)",
+        "Generic or missing source URL",
+        "Minimal tags (1 only)"
+      ],
+      "suggestions": {
+        "descriptionTip": "Current: \"gcloud-sdk\" - Consider expanding with purpose/features",
+        "sourceUrl": "https://github.com/gcloud-sdk/gcloud-sdk",
+        "additionalTags": [
+          "cloud"
+        ]
+      }
+    },
+    {
+      "name": "gemini",
+      "issues": [
+        "Minimal tags (2 only)"
+      ],
+      "suggestions": {}
+    }
+  ],
+  "totalSuggestions": 142
+}

package/plugins/acp/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "acp",
+  "binary": "npx",
+  "check": "which npx",
+  "install_steps": [
+    "npx is included with Node.js — install from nodejs.org",
+    "Verify: npx --version",
+    "supercli plugins install ./plugins/acp --on-conflict replace --json"
+  ],
+  "note": "ACP is a protocol. Each server is distributed separately via npx/binary. This plugin provides the registry interface and launcher for all 35+ ACP agents. Requires Node.js for npx-based agents."
+}

package/plugins/acp/meta.json

@@ -0,0 +1,72 @@
+{
+  "description": "acp — Agent Communication Protocol CLI. 35+ coding agents (Claude, Gemini, Cursor, Copilot, Cline, Goose, Codex, Kilo, Junie, Qwen, Mistral, Kimi, OpenCode, etc.). ACP standardizes communication between editors and AI coding agents. 3k+ stars.",
+  "tags": ["acp", "agent", "protocol", "ai", "coding-agent", "llm", "cli", "rust"],
+  "has_learn": true,
+  "agents": {
+    "note": "Status: ok=works out of box, auth=needs API key, timeout=first-run delay possible, skip=not installable automatically",
+    "working_out_of_box": {
+      "description": "These ACP servers work with initialize + session/new + prompt without any API keys. Use these first.",
+      "agents": ["opencode", "dirac", "agoragentic-acp"]
+    },
+    "works_with_free_model": {
+      "description": "Handshake OK, prompt needs model override via --model flag or OpenRouter config. Add openrouter provider to enable free model routing.",
+      "agents": ["opencode", "claude-acp", "qoder", "auggie"]
+    },
+    "handshake_ok_auth_gated": {
+      "description": "Initialize + session/new work, but prompts need API keys. Override model via --model flag if the agent supports custom providers.",
+      "agents": {
+        "cline": "needs ANTHROPIC_API_KEY",
+        "goose": "needs GOOGLE_API_KEY or ANTHROPIC_API_KEY",
+        "kimi": "needs KIMI_API_KEY",
+        "dimcode": "needs OPENAI_API_KEY",
+        "glm-acp-agent": "needs Z_AI_API_KEY",
+        "deepagents": "needs API key",
+        "pi-acp": "needs API key",
+        "nova": "needs API key",
+        "fast-agent": "needs API key",
+        "qwen-code": "needs API key",
+        "autohand": "needs API key",
+        "codebuddy-code": "needs API key",
+        "junie": "needs JetBrains account",
+        "gemini": "needs GEMINI_API_KEY (free tier available)",
+        "github-copilot-cli": "needs GitHub Copilot subscription",
+        "claude-acp": "can use OpenRouter free model via --model flag"
+      }
+    },
+    "first_run_slow": {
+      "description": "npx agents that take >15s on first run due to package download. Be patient or pre-install.",
+      "agents": ["gemini", "factory-droid", "minion-code", "qwen-code", "nova"]
+    },
+    "binary_not_auto_installable": {
+      "description": "Require manual download from GitHub releases. Cannot auto-install via acp-cli.",
+      "agents": {
+        "amp": "github.com/amp-codes/amp",
+        "codex-acp": "github.com/openai/codex",
+        "cortex-code": "github.com/cortex/cortex-code",
+        "corust-agent": "github.com/corust/corust",
+        "crow-cli": "github.com/crow/crow-cli",
+        "cursor": "cursor.com",
+        "kilo": "github.com/kilocode/kilo",
+        "mistral-vibe": "github.com/mistralai/mistral-vibe",
+        "poolside": "poolside.ai",
+        "sigit": "github.com/sigit/sigit",
+        "stakpak": "stakpak.dev",
+        "vtcode": "github.com/vtcode/vtcode"
+      }
+    },
+    "openrouter_setup": {
+      "steps": [
+        "1. Get API key from openrouter.ai/keys",
+        "2. Add provider to opencode config (~/.config/opencode/opencode.json):",
+        "   \"openrouter\": { \"npm\": \"@ai-sdk/openai-compatible\", \"name\": \"OpenRouter.ai\", \"options\": { \"baseURL\": \"https://openrouter.ai/api/v1\", \"apiKey\": \"sk-or-v1-...\" }, \"models\": { \"free\": {\"name\": \"openrouter/free\"}, \"mimo-v2-flash\": {\"name\": \"xiaomi/mimo-v2-flash\"} } }",
+        "3. Use with acp-cli: --model xiaomi/mimo-v2-flash or --model openrouter/free",
+        "4. Free models that work: xiaomi/mimo-v2-flash, openrouter/free, google/gemini-2.0-flash-exp"
+      ]
+    },
+    "model_override_notes": {
+      "protocol": "ACP session/set_config_option with params: { sessionId, configId: 'model', value: 'provider/model-name', type: true }",
+      "compatible_agents": ["opencode", "claude-acp", "qoder"],
+      "known_model_format": "provider/model-name (e.g. xiaomi/mimo-v2-flash, openrouter/free, nvidia-minimax/zai-org/GLM-5.1-FP8)"
+    }
+  }
+}