superacli 1.1.26 → 1.1.28

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

@@ -0,0 +1,178 @@
+# RustScan Quickstart Guide
+
+RustScan is an ultra-fast port scanner written in Rust. It can scan all 65,000 ports in approximately 3 seconds, making it one of the fastest port scanners available. It's designed for network security professionals, penetration testers, and system administrators.
+
+## Installation
+
+```bash
+cargo install rustscan
+```
+
+Or via Homebrew:
+```bash
+brew install rustscan
+```
+
+## Basic Usage
+
+### Scan all ports on a single host
+```bash
+rustscan -a 192.168.1.1
+```
+
+### Scan specific ports
+```bash
+rustscan -p 80,443,8080 192.168.1.1
+```
+
+### Scan port range
+```bash
+rustscan -p 1-1000 192.168.1.1
+```
+
+### Scan with hostname
+```bash
+rustscan -a example.com
+```
+
+## Common Options
+
+- `-a <TARGET>` - Target IP address, hostname, or CIDR range
+- `-p <PORTS>` - Ports or port ranges to scan (default: top 1000)
+- `-r <RATE>` - Socket timeout in seconds (default: 5)
+- `-t <THREADS>` - Number of parallel connections (default: auto)
+- `--top` - Scan top N common ports
+- `-s` - Scan slower but more reliable
+- `--script <SCRIPT>` - Execute custom scripts after scan (nmap-safe, etc.)
+- `-l <FILE>` - Load list of hosts from file
+- `-x <FILE>` - Exclude IP addresses from file
+
+## Advanced Usage
+
+### Scan entire subnet
+```bash
+rustscan -a 192.168.0.0/24
+```
+
+### Scan from file with hostnames
+```bash
+rustscan -l targets.txt
+```
+
+### Integrate with Nmap for detailed analysis
+```bash
+rustscan -a 192.168.1.1 -- -A
+```
+
+### Exclude specific hosts
+```bash
+rustscan -a 192.168.0.0/24 -x excluded.txt
+```
+
+### Scan only top 100 ports
+```bash
+rustscan --top 100 192.168.1.1
+```
+
+## Performance Tips
+
+- RustScan is fast by default; increase `-t` (threads) for even faster scanning
+- Use `-s` (slower mode) for more reliable results on unstable networks
+- Scan top ports first (`--top 1000`) then expand range as needed
+- Batch multiple targets for better efficiency
+
+## Output Examples
+
+```bash
+# Basic output
+rustscan -a 192.168.1.1 -p 80,443
+
+# JSON output
+rustscan -a 192.168.1.1 -p 80,443 --format json
+
+# Scan with service detection (via Nmap script)
+rustscan -a 192.168.1.1 --script nmap-safe
+```
+
+## Real-world Use Cases
+
+### Quick vulnerability scan on internal network
+```bash
+rustscan -a 192.168.0.0/24 -p 80,443,3306,5432,6379
+```
+
+### Penetration testing - scan all ports
+```bash
+rustscan -a target.com -p 1-65535
+```
+
+### Monitor for unexpected open ports
+```bash
+rustscan -a 10.0.0.5 -p 1-10000 > baseline.txt
+# Compare later
+rustscan -a 10.0.0.5 -p 1-10000 > current.txt
+diff baseline.txt current.txt
+```
+
+### CI/CD pipeline security check
+```bash
+#!/bin/bash
+rustscan -a localhost -p 1-65535 | grep -q "OPEN" && echo "Unexpected ports found!" && exit 1
+```
+
+## Comparison to Nmap
+
+| Aspect | RustScan | Nmap |
+|--------|----------|------|
+| Speed | Ultra-fast (3s for all ports) | Slower (detailed analysis) |
+| Use Case | Port discovery | Deep protocol analysis |
+| Scripting | Limited (Lua, Python, Shell) | Extensive NSE scripts |
+| Learning Curve | Easy | Steeper |
+
+## Integration with Other Tools
+
+### Pipe to Nmap for service detection
+```bash
+rustscan -a target.com -- -sV -sC
+```
+
+### Chain with other security tools
+```bash
+rustscan -a target.com -p 80 | xargs -I {} curl http://{}
+```
+
+## Ethical Considerations
+
+- **Always get permission** before scanning networks you don't own
+- Unauthorized network scanning may be illegal in your jurisdiction
+- Use RustScan responsibly for:
+  - Your own infrastructure
+  - Authorized penetration testing engagements
+  - Security research with permission
+  - Network administration and monitoring
+
+## Resources
+
+- [GitHub Repository](https://github.com/RustScan/RustScan)
+- [Official Documentation](https://github.com/RustScan/RustScan/wiki)
+- [GitHub Issues & Feature Requests](https://github.com/RustScan/RustScan/issues)
+
+## Troubleshooting
+
+### "Permission denied" error
+RustScan requires elevated privileges for some operations. Use `sudo` if needed:
+```bash
+sudo rustscan -a 192.168.1.1
+```
+
+### Timeout issues
+Increase socket timeout:
+```bash
+rustscan -a target.com -r 10
+```
+
+### Too many connections
+Reduce thread count:
+```bash
+rustscan -a target.com -t 100
+```

package/plugins/rye/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "rye",
+  "binary": "rye",
+  "check": "which rye",
+  "install_steps": [
+    "curl -fsSL https://rye.astral.sh/get | bash",
+    "Verify: rye --version",
+    "supercli plugins install ./plugins/rye --on-conflict replace --json"
+  ],
+  "note": "Also available via: pip install rye, brew. Requires restarting shell after install."
+}

package/plugins/rye/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "rye — Python package manager with uv backend. Features lockfile, workspace support, and seamless Python version management. By Astral (creators of Ruff).",
+  "tags": ["rye", "python", "package-manager", "dependencies", "astral", "cli"],
+  "has_learn": true
+}

package/plugins/rye/plugin.json

@@ -0,0 +1,152 @@
+{
+  "name": "rye",
+  "version": "0.1.0",
+  "description": "rye — Python package manager with uv backend, lockfile, and workspace support",
+  "source": "https://github.com/astral-sh/rye",
+  "checks": [
+    { "type": "binary", "name": "rye" }
+  ],
+  "install_guidance": {
+    "plugin": "rye",
+    "binary": "rye",
+    "check": "which rye",
+    "install_steps": [
+      "curl -fsSL https://rye.astral.sh/get | bash",
+      "Verify: rye --version",
+      "supercli plugins install ./plugins/rye --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "rye",
+      "resource": "self",
+      "action": "version",
+      "description": "Print rye version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install rye: curl -fsSL https://rye.astral.sh/get | bash"
+      },
+      "args": []
+    },
+    {
+      "namespace": "rye",
+      "resource": "init",
+      "action": "run",
+      "description": "Initialize a new Python project",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["init"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": [
+        { "name": "name", "type": "string", "required": false, "description": "Project name" }
+      ]
+    },
+    {
+      "namespace": "rye",
+      "resource": "sync",
+      "action": "run",
+      "description": "Sync environment with lockfile",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["sync"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": []
+    },
+    {
+      "namespace": "rye",
+      "resource": "add",
+      "action": "run",
+      "description": "Add a Python package dependency",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["add"],
+        "positionalArgs": ["package"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": [
+        { "name": "package", "type": "string", "required": true, "description": "Package name" }
+      ]
+    },
+    {
+      "namespace": "rye",
+      "resource": "build",
+      "action": "run",
+      "description": "Build Python package",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["build"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": []
+    },
+    {
+      "namespace": "rye",
+      "resource": "publish",
+      "action": "run",
+      "description": "Publish package to PyPI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["publish"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": []
+    },
+    {
+      "namespace": "rye",
+      "resource": "lock",
+      "action": "run",
+      "description": "Generate lockfile",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "baseArgs": ["lock"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": []
+    },
+    {
+      "namespace": "rye",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to rye CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "rye",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "missingDependencyHelp": "Install rye"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,54 @@
+---
+name: rye
+description: Use this skill when the user wants to manage Python projects, install dependencies with lockfile, sync environments, publish packages, or use the uv-backed Python package manager.
+---
+
+# rye Plugin
+
+Python package manager with uv backend, lockfile, and workspace support.
+
+## Commands
+
+### Project
+- `rye init run` — Initialize a new Python project
+- `rye build run` — Build Python package
+- `rye publish run` — Publish package to PyPI
+
+### Dependencies
+- `rye sync run` — Sync environment with lockfile
+- `rye add run` — Add a Python package dependency
+- `rye lock run` — Generate lockfile
+
+## Usage Examples
+- "Initialize a new Python project with rye"
+- "Install dependencies from lockfile"
+- "Add a package dependency"
+- "Build and publish my package"
+
+## Installation
+
+```bash
+curl -fsSL https://rye.astral.sh/get | bash
+```
+
+## Examples
+
+```bash
+# Init new project
+rye init my-project
+
+# Add dependency
+rye add requests
+
+# Sync environment
+rye sync
+
+# Lock dependencies
+rye lock
+
+# Build
+rye build
+
+# Publish
+rye publish
+```

package/plugins/scaleway/install-guidance.json

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

package/plugins/scaleway/meta.json

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

package/plugins/scaleway/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/scaleway/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# scaleway

package/plugins/serde/install-guidance.json

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

package/plugins/serde/meta.json

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

package/plugins/serde/plugin.json

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

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

@@ -0,0 +1 @@
+# serde

package/plugins/serde-json/install-guidance.json

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

package/plugins/serde-json/meta.json

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

package/plugins/serde-json/plugin.json

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

package/plugins/serde-json/skills/quickstart/SKILL.md

@@ -0,0 +1 @@
+# serde-json

package/plugins/shellcheck/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "shellcheck",
+  "binary": "shellcheck",
+  "check": "which shellcheck",
+  "install_steps": [
+    "brew install shellcheck",
+    "Verify: shellcheck --version",
+    "supercli plugins install ./plugins/shellcheck --on-conflict replace --json"
+  ],
+  "note": "Also available via: apt, pacman, dnf, pkg, choco, scoop, winget."
+}

package/plugins/shellcheck/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "shellcheck — static analysis tool for shell scripts. Finds bugs, warns about syntax issues, and suggests improvements for bash/sh scripts. 39k+ stars.",
+  "tags": ["shellcheck", "shell", "bash", "linter", "static-analysis", "haskell", "cli"],
+  "has_learn": true
+}

package/plugins/shellcheck/plugin.json

@@ -0,0 +1,88 @@
+{
+  "name": "shellcheck",
+  "version": "0.1.0",
+  "description": "shellcheck — static analysis tool for shell scripts (bash/sh)",
+  "source": "https://github.com/koalaman/shellcheck",
+  "checks": [
+    { "type": "binary", "name": "shellcheck" }
+  ],
+  "install_guidance": {
+    "plugin": "shellcheck",
+    "binary": "shellcheck",
+    "check": "which shellcheck",
+    "install_steps": [
+      "brew install shellcheck",
+      "Verify: shellcheck --version",
+      "supercli plugins install ./plugins/shellcheck --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "shellcheck",
+      "resource": "self",
+      "action": "version",
+      "description": "Print shellcheck version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "shellcheck",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install shellcheck: brew install shellcheck"
+      },
+      "args": []
+    },
+    {
+      "namespace": "shellcheck",
+      "resource": "check",
+      "action": "run",
+      "description": "Lint a shell script",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "shellcheck",
+        "positionalArgs": ["script"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install shellcheck"
+      },
+      "args": [
+        { "name": "script", "type": "string", "required": true, "description": "Shell script file to check" },
+        { "name": "severity", "type": "string", "required": false, "description": "Minimum severity: error, warning, info, style" }
+      ]
+    },
+    {
+      "namespace": "shellcheck",
+      "resource": "check",
+      "action": "json",
+      "description": "Lint script and output JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "shellcheck",
+        "baseArgs": ["--format", "json"],
+        "positionalArgs": ["script"],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install shellcheck"
+      },
+      "args": [
+        { "name": "script", "type": "string", "required": true, "description": "Shell script file to check" }
+      ]
+    },
+    {
+      "namespace": "shellcheck",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to shellcheck CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "shellcheck",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "missingDependencyHelp": "Install shellcheck"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,51 @@
+---
+name: shellcheck
+description: Use this skill when the user wants to lint shell scripts, check bash/sh scripts for errors, find bugs in shell code, or improve script quality.
+---
+
+# shellcheck Plugin
+
+Static analysis tool for shell scripts (bash/sh).
+
+## Commands
+
+### Check
+- `shellcheck check run` — Lint a shell script
+- `shellcheck check json` — Lint script and output JSON
+
+## Usage Examples
+- "Check this shell script for errors"
+- "Lint my bash script"
+- "Find bugs in deploy.sh"
+- "Check script and output as JSON"
+
+## Installation
+
+```bash
+brew install shellcheck
+```
+
+## Examples
+
+```bash
+# Basic check
+shellcheck myscript.sh
+
+# JSON output
+shellcheck --format json myscript.sh
+
+# Set minimum severity
+shellcheck --severity=warning myscript.sh
+
+# Check multiple files
+shellcheck *.sh
+
+# Source files
+shellcheck --source-path=SRC myscript.sh
+```
+
+## Key Features
+- 300+ built-in checks
+- JSON, CheckStyle, GCC output formats
+- CI integration
+- Editor integrations (VSCode, Vim, Emacs)

package/plugins/shfmt/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "shfmt",
+  "binary": "shfmt",
+  "check": "which shfmt",
+  "install_steps": [
+    "go install mvdan.cc/sh/v3/cmd/shfmt@latest",
+    "Verify: shfmt --version",
+    "supercli plugins install ./plugins/shfmt --on-conflict replace --json"
+  ],
+  "note": "Also available via: brew, apt, pacman, dnf, scoop, docker (mvdan/shfmt). Requires Go toolchain for go install."
+}

package/plugins/shfmt/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "shfmt — shell script formatter supporting bash, POSIX shell, mksh, and zsh. Part of mvdan/sh, 8.7k+ stars.",
+  "tags": ["shfmt", "shell", "bash", "formatter", "go", "cli"],
+  "has_learn": true
+}