superacli 1.1.26 → 1.1.28

package/plugins/acp-cli/plugin.json

@@ -0,0 +1,124 @@
+{
+  "name": "acp-cli",
+  "version": "0.1.0",
+  "description": "acp-cli — consume ACP coding agents via JSON-RPC. Create sessions, send prompts, stream completions from 35+ ACP agents (Claude, Gemini, Cursor, Copilot, Cline, Goose, Codex, etc.)",
+  "source": "https://github.com/agentclientprotocol/agent-client-protocol",
+  "checks": [
+    { "type": "binary", "name": "node" }
+  ],
+  "install_guidance": {
+    "plugin": "acp-cli",
+    "binary": "acp-cli.js",
+    "check": "which node",
+    "install_steps": [
+      "Install Node.js from nodejs.org",
+      "acp-cli.js is bundled with the plugin",
+      "Verify: node plugins/acp-cli/acp-cli.js help",
+      "supercli plugins install ./plugins/acp-cli --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "acp-cli",
+      "resource": "registry",
+      "action": "list",
+      "description": "List all 35+ ACP agents from registry",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js", "registry"],
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": []
+    },
+    {
+      "namespace": "acp-cli",
+      "resource": "registry",
+      "action": "info",
+      "description": "Show details for a specific ACP agent",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js", "registry:info"],
+        "positionalArgs": ["agent_id"],
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": [
+        { "name": "agent_id", "type": "string", "required": true, "description": "ACP agent ID (e.g., claude-acp, gemini, cursor)" }
+      ]
+    },
+    {
+      "namespace": "acp-cli",
+      "resource": "session",
+      "action": "create",
+      "description": "Create a new session with an ACP agent and optionally send a prompt. Set --model to override the AI model via ACP protocol (sends session/set_config_option).",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js", "session:create"],
+        "positionalArgs": ["agent_id"],
+        "passthrough": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": [
+        { "name": "agent_id", "type": "string", "required": true, "description": "ACP agent npx package or binary path (e.g., @google/gemini-cli, @agentclientprotocol/claude-agent-acp)" },
+        { "name": "prompt", "type": "string", "required": false, "description": "Prompt text to send after session creation (--prompt)" },
+        { "name": "model", "type": "string", "required": false, "description": "Override model via ACP protocol (--model provider/model, e.g. nvidia-minimax/zai-org/GLM-5.1-FP8)" },
+        { "name": "mode", "type": "string", "required": false, "description": "Set session mode (--mode ask|code|architect)" },
+        { "name": "cwd", "type": "string", "required": false, "description": "Working directory (--cwd)" }
+      ]
+    },
+    {
+      "namespace": "acp-cli",
+      "resource": "server",
+      "action": "start",
+      "description": "Launch an ACP server via npx (initialize handshake only)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js", "server:start"],
+        "positionalArgs": ["package"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": [
+        { "name": "package", "type": "string", "required": true, "description": "npx package name (e.g., @google/gemini-cli)" },
+        { "name": "cwd", "type": "string", "required": false, "description": "Working directory (--cwd)" }
+      ]
+    },
+    {
+      "namespace": "acp-cli",
+      "resource": "_",
+      "action": "help",
+      "description": "Show acp-cli help",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js", "help"],
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": []
+    },
+    {
+      "namespace": "acp-cli",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to acp-cli.js",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["acp-cli.js"],
+        "passthrough": true,
+        "missingDependencyHelp": "Install Node.js"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/acp-cli/skills/quickstart/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: acp-cli
+description: Use this skill when the user wants to interact with ACP coding agents from the terminal — list agents, create sessions, send prompts, stream completions, or consume Claude/Gemini/Cursor/Copilot via the Agent Communication Protocol.
+---
+
+# acp-cli Plugin
+
+Consume ACP coding agents directly from the CLI. The Agent Communication Protocol (ACP) connects editors to AI coding agents via JSON-RPC over stdio.
+
+## Commands
+
+### Registry
+- `acp-cli registry list` — List all 35+ ACP agents from the official registry
+- `acp-cli registry info` — Show details for a specific ACP agent
+
+### Sessions
+- `acp-cli session create` — Create a new session with an ACP agent and optionally send a prompt
+- `acp-cli server start` — Launch an ACP server and perform initialize handshake
+
+### Help
+- `acp-cli _ help` — Show acp-cli help
+
+## Usage Examples
+- "List all available ACP coding agents"
+- "Show details about claude-acp agent"
+- "Start a Gemini CLI ACP session and ask a question"
+- "Create an ACP session with Claude Agent"
+- "What ACP agents are registered for coding?"
+
+## Installation
+
+Requires Node.js (for the bundled acp-cli.js script). No npm install needed — the script is self-contained.
+
+## Quick Start
+
+```bash
+# List all ACP agents
+acp-cli registry list
+
+# Show info about a specific agent
+acp-cli registry info claude-acp
+
+# Create a session with Gemini CLI and send a prompt
+acp-cli session create @google/gemini-cli --prompt "Write a hello world in Rust"
+
+# Create a session with Claude Agent
+ANTHROPIC_API_KEY=sk-... acp-cli session:create @agentclientprotocol/claude-agent-acp --prompt "Explain monads"
+
+# Launch a server and inspect the initialize handshake
+acp-cli server:start @google/gemini-cli
+```
+
+## ACP Agent References
+
+| Agent ID | npx/Binary | Env Key Required |
+|----------|-----------|-----------------|
+| claude-acp | @agentclientprotocol/claude-agent-acp | ANTHROPIC_API_KEY |
+| gemini | @google/gemini-cli | GEMINI_API_KEY |
+| copilot | @github/copilot | GITHUB_TOKEN |
+| cline | cline | ANTHROPIC_API_KEY |
+| kilo | @kilocode/cli | — |
+| codex | @zed-industries/codex-acp | CODEX_API_KEY |
+| qwen | @qwen-code/qwen-code | — |
+| deepagents | deepagents-acp | — |
+| dimcode | dimcode | — |
+| auggie | @augmentcode/auggie | — |
+| dirac | dirac-cli | — |
+| nova | @compass-ai/nova | — |
+| glm | glm-acp-agent | — |
+| autohand | @autohandai/autohand-acp | — |
+
+## How It Works
+
+ACP uses JSON-RPC 2.0 over stdio:
+1. Client spawns the agent process
+2. Sends `initialize` request with capabilities
+3. Agent responds with protocol version + agent info
+4. Client sends `sessions/new` to create a session
+5. Client sends `sessions/prompt` with the prompt
+6. Agent streams responses via `session/update` notifications
+7. Session closes when done
+
+## Notes
+- ACP agents are launched as subprocesses — no server daemon needed
+- Each agent requires its own API key (set as environment variable)
+- The session create command uses `npx` to auto-install agent packages
+- Binary-only agents (Cursor, Goose, Junie, etc.) need manual installation

package/plugins/actix/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"actix","binary":"actix","check":"which actix","install_steps":["cargo install actix","Verify: actix --version","supercli plugins install ./plugins/actix --on-conflict replace --json"]}

package/plugins/actix/meta.json

@@ -0,0 +1 @@
+{"description":"actix","tags":["actix"],"has_learn":true}

package/plugins/actix/plugin.json

@@ -0,0 +1 @@
+{"name":"actix","version":"0.1.0","description":"actix","source":"https://github.com","checks":[{"type":"binary","name":"actix"}],"install_guidance":{"plugin":"actix","binary":"actix","check":"which actix","install_steps":["cargo install actix","Verify: actix --version","supercli plugins install ./plugins/actix --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"actix","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"actix","baseArgs":["--version"],"missingDependencyHelp":"Install actix"},"args":[]}]}

package/plugins/actix/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# actix

package/plugins/agency-agents/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "agency-agents",
+  "binary": "agency-agents",
+  "check": "which agency-agents",
+  "install_steps": [
+    "brew install agency-agents",
+    "Verify: agency-agents --version",
+    "supercli plugins install ./plugins/agency-agents --on-conflict replace --json"
+  ]
+}

package/plugins/agency-agents/meta.json

@@ -0,0 +1,7 @@
+{
+  "description": "Remote skills index for msitarzewski/agency-agents",
+  "tags": [
+    "agency-agents"
+  ],
+  "has_learn": false
+}

package/plugins/agent-browser/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "agent-browser",
+  "binary": "agent-browser",
+  "check": "which agent-browser",
+  "install_steps": [
+    "brew install agent-browser",
+    "Verify: agent-browser --version",
+    "supercli plugins install ./plugins/agent-browser --on-conflict replace --json"
+  ]
+}

package/plugins/agent-browser/meta.json

@@ -0,0 +1,8 @@
+{
+  "description": "agent-browser CLI plugin with quick wrappers and passthrough",
+  "tags": [
+    "agent-browser",
+    "cli"
+  ],
+  "has_learn": true
+}

package/plugins/aider/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "aider",
+  "binary": "aider",
+  "check": "which aider",
+  "install_steps": [
+    "brew install aider",
+    "Verify: aider --version",
+    "supercli plugins install ./plugins/aider --on-conflict replace --json"
+  ]
+}

package/plugins/aider/meta.json

@@ -0,0 +1,9 @@
+{
+  "description": "Aider CLI plugin with one-shot non-interactive coding wrappers",
+  "tags": [
+    "aider",
+    "cli",
+    "ai"
+  ],
+  "has_learn": true
+}

package/plugins/asciidoctor/install-guidance.json

@@ -0,0 +1,6 @@
+{
+  "plugin": "asciidoctor",
+  "binary": "asciidoctor",
+  "check": "which asciidoctor",
+  "install_steps": ["brew install asciidoctor", "Verify: asciidoctor --version", "supercli plugins install ./plugins/asciidoctor --on-conflict replace --json"]
+}

package/plugins/asciidoctor/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "asciidoctor is a fast text processor that converts AsciiDoc content to HTML, PDF, EPUB, and other formats. Great for documentation, technical writing, and slides.",
+  "tags": ["asciidoctor", "asciidoc", "documentation", "processor"],
+  "has_learn": true
+}

package/plugins/asciidoctor/plugin.json

@@ -0,0 +1,51 @@
+{
+  "name": "asciidoctor",
+  "version": "0.1.0",
+  "description": "asciidoctor — AsciiDoc processor for documents, books, and slides",
+  "source": "https://github.com/asciidoctor/asciidoctor",
+  "checks": [{"type": "binary", "name": "asciidoctor"}],
+  "install_guidance": {
+    "plugin": "asciidoctor",
+    "binary": "asciidoctor",
+    "check": "which asciidoctor",
+    "install_steps": ["brew install asciidoctor", "Verify: asciidoctor --version", "supercli plugins install ./plugins/asciidoctor --on-conflict replace --json"]
+  },
+  "learn": {"file": "skills/quickstart/SKILL.md"},
+  "commands": [
+    {
+      "namespace": "asciidoctor",
+      "resource": "self",
+      "action": "version",
+      "description": "Print asciidoctor version",
+      "adapter": "process",
+      "adapterConfig": {"command": "asciidoctor", "baseArgs": ["--version"], "missingDependencyHelp": "Install: brew install asciidoctor"},
+      "args": []
+    },
+    {
+      "namespace": "asciidoctor",
+      "resource": "convert",
+      "action": "html",
+      "description": "Convert AsciiDoc to HTML",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "asciidoctor",
+        "baseArgs": ["-b", "html5"],
+        "positionalArgs": ["file"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install asciidoctor"
+      },
+      "args": [{"name": "file", "type": "string", "required": true, "description": "AsciiDoc file"}]
+    },
+    {
+      "namespace": "asciidoctor",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to asciidoctor CLI",
+      "adapter": "process",
+      "adapterConfig": {"command": "asciidoctor", "cwd": "invoke_cwd", "passthrough": true, "missingDependencyHelp": "Install asciidoctor"},
+      "args": []
+    }
+  ]
+}

package/plugins/asciidoctor/skills/quickstart/SKILL.md

@@ -0,0 +1,20 @@
+# asciidoctor Quickstart
+
+asciidoctor converts AsciiDoc to HTML, PDF, and other formats.
+
+## Installation
+
+```bash
+brew install asciidoctor
+```
+
+## Basic Usage
+
+```bash
+asciidoctor document.adoc
+```
+
+## Resources
+
+- [GitHub](https://github.com/asciidoctor/asciidoctor)
+- [Docs](https://asciidoctor.org/)

package/plugins/ash/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"ash","binary":"ash","check":"which ash","install_steps":["brew install ash","Verify: ash --version","supercli plugins install ./plugins/ash --on-conflict replace --json"]}

package/plugins/ash/meta.json

@@ -0,0 +1 @@
+{"description":"ash","tags":["ash"],"has_learn":true}

package/plugins/ash/plugin.json

@@ -0,0 +1 @@
+{"name":"ash","version":"0.1.0","description":"ash tool","source":"https://github.com","checks":[{"type":"binary","name":"ash"}],"install_guidance":{"plugin":"ash","binary":"ash","check":"which ash","install_steps":["brew install ash","Verify: ash --version","supercli plugins install ./plugins/ash --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"ash","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"ash","baseArgs":["--version"],"missingDependencyHelp":"Install ash"},"args":[]}]}

package/plugins/ash/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# ash

package/plugins/atuin/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"atuin","binary":"atuin","check":"which atuin","install_steps":["brew install atuin","Verify: atuin --version","supercli plugins install ./plugins/atuin --on-conflict replace --json"]}

package/plugins/atuin/meta.json

@@ -0,0 +1 @@
+{"description":"atuin","tags":["atuin"],"has_learn":true}

package/plugins/atuin/plugin.json

@@ -0,0 +1 @@
+{"name":"atuin","version":"0.1.0","description":"atuin tool","source":"https://github.com","checks":[{"type":"binary","name":"atuin"}],"install_guidance":{"plugin":"atuin","binary":"atuin","check":"which atuin","install_steps":["brew install atuin","Verify: atuin --version","supercli plugins install ./plugins/atuin --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"atuin","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"atuin","baseArgs":["--version"],"missingDependencyHelp":"Install atuin"},"args":[]}]}

package/plugins/atuin/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# atuin

package/plugins/aws/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "aws",
+  "binary": "aws",
+  "check": "which aws",
+  "install_steps": [
+    "brew install aws",
+    "Verify: aws --version",
+    "supercli plugins install ./plugins/aws --on-conflict replace --json"
+  ]
+}

package/plugins/aws/meta.json

@@ -0,0 +1,8 @@
+{
+  "description": "AWS CLI plugin for dcli",
+  "tags": [
+    "aws",
+    "cli"
+  ],
+  "has_learn": false
+}

package/plugins/aws-cli/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"aws-cli","binary":"aws-cli","check":"which aws-cli","install_steps":["brew install aws-cli","Verify: aws-cli --version","supercli plugins install ./plugins/aws-cli --on-conflict replace --json"]}

package/plugins/aws-cli/meta.json

@@ -0,0 +1 @@
+{"description":"aws-cli","tags":["aws-cli"],"has_learn":true}

package/plugins/aws-cli/plugin.json

@@ -0,0 +1 @@
+{"name":"TOOL","version":"0.1.0","description":"Tool","source":"https://github.com","checks":[{"type":"binary","name":"TOOL"}],"install_guidance":{"plugin":"TOOL","binary":"TOOL","check":"which TOOL","install_steps":["brew install TOOL","Verify: TOOL --version","supercli plugins install ./plugins/TOOL --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"TOOL","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"TOOL","baseArgs":["--version"],"missingDependencyHelp":"Install TOOL"},"args":[]}]}

package/plugins/aws-cli/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# aws-cli

package/plugins/az/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "az",
+  "binary": "az",
+  "check": "which az",
+  "install_steps": [
+    "brew install az",
+    "Verify: az --version",
+    "supercli plugins install ./plugins/az --on-conflict replace --json"
+  ]
+}

package/plugins/az/meta.json

@@ -0,0 +1,8 @@
+{
+  "description": "Azure CLI plugin for dcli",
+  "tags": [
+    "az",
+    "cli"
+  ],
+  "has_learn": false
+}

package/plugins/azd/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "azd",
+  "binary": "azd",
+  "check": "which azd",
+  "install_steps": [
+    "brew install azd",
+    "Verify: azd --version",
+    "supercli plugins install ./plugins/azd --on-conflict replace --json"
+  ]
+}

package/plugins/azd/meta.json

@@ -0,0 +1,8 @@
+{
+  "description": "Azure Developer CLI plugin with non-interactive wrappers and passthrough",
+  "tags": [
+    "azd",
+    "cli"
+  ],
+  "has_learn": true
+}

package/plugins/azure-cli/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"azure-cli","binary":"azure-cli","check":"which azure-cli","install_steps":["brew install azure-cli","Verify: azure-cli --version","supercli plugins install ./plugins/azure-cli --on-conflict replace --json"]}

package/plugins/azure-cli/meta.json

@@ -0,0 +1 @@
+{"description":"azure-cli","tags":["azure-cli"],"has_learn":true}

package/plugins/azure-cli/plugin.json

@@ -0,0 +1 @@
+{"name":"TOOL","version":"0.1.0","description":"Tool","source":"https://github.com","checks":[{"type":"binary","name":"TOOL"}],"install_guidance":{"plugin":"TOOL","binary":"TOOL","check":"which TOOL","install_steps":["brew install TOOL","Verify: TOOL --version","supercli plugins install ./plugins/TOOL --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"TOOL","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"TOOL","baseArgs":["--version"],"missingDependencyHelp":"Install TOOL"},"args":[]}]}

package/plugins/azure-cli/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# azure-cli

package/plugins/bandit/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "bandit",
+  "binary": "bandit",
+  "check": "which bandit",
+  "install_steps": [
+    "pip install bandit",
+    "Verify: bandit --version",
+    "supercli plugins install ./plugins/bandit --on-conflict replace --json"
+  ],
+  "note": "Requires Python."
+}

package/plugins/bandit/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "bandit — security linter for Python code. Finds common security issues like SQL injection, command injection, hardcoded passwords, and unsafe imports.",
+  "tags": ["bandit", "security", "python", "linter", "cli"],
+  "has_learn": true
+}

package/plugins/bandit/plugin.json

@@ -0,0 +1,88 @@
+{
+  "name": "bandit",
+  "version": "0.1.0",
+  "description": "bandit — Python security linter to find common security issues",
+  "source": "https://github.com/PyCQA/bandit",
+  "checks": [
+    { "type": "binary", "name": "bandit" }
+  ],
+  "install_guidance": {
+    "plugin": "bandit",
+    "binary": "bandit",
+    "check": "which bandit",
+    "install_steps": [
+      "pip install bandit",
+      "Verify: bandit --version",
+      "supercli plugins install ./plugins/bandit --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "bandit",
+      "resource": "self",
+      "action": "version",
+      "description": "Print bandit version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "bandit",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install bandit: pip install bandit"
+      },
+      "args": []
+    },
+    {
+      "namespace": "bandit",
+      "resource": "scan",
+      "action": "run",
+      "description": "Scan Python files for security issues",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "bandit",
+        "baseArgs": ["-r"],
+        "positionalArgs": ["path"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install bandit"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": false, "description": "File or directory to scan" }
+      ]
+    },
+    {
+      "namespace": "bandit",
+      "resource": "scan",
+      "action": "json",
+      "description": "Scan and output JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "bandit",
+        "baseArgs": ["-r", "--format", "json"],
+        "positionalArgs": ["path"],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install bandit"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": false, "description": "File or directory to scan" }
+      ]
+    },
+    {
+      "namespace": "bandit",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to bandit CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "bandit",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "missingDependencyHelp": "Install bandit"
+      },
+      "args": []
+    }
+  ]
+}