superacli 1.1.26 → 1.1.27

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

@@ -1,99 +1,11 @@
-# starship Plugin
+# Quickstart
 
-## Overview
-The starship plugin provides the minimal, blazing-fast, and infinitely customizable prompt for any shell. Written in Rust for speed and efficiency.
+See repository documentation for full details and examples.
 
-## What is starship?
-`starship` is a cross-shell prompt that displays information from your system, git status, and more. It's written in Rust for maximum speed and works with bash, zsh, fish, and more.
+## Installation
 
-## Quick Start
-
-### 1. Install starship
-```bash
-curl -sS https://starship.rs/install.sh | sh
-```
-
-### 2. Initialize for your shell
-Add to your shell config:
-```bash
-# For bash
-eval "$(starship init bash)"
-
-# For zsh
-eval "$(starship init zsh)"
-
-# For fish
-starship init fish | source
-```
-
-### 3. Verify installation
-```bash
-sc starship self version
-```
-
-## Features
-- **Git Integration**: Branch, status, commit info
-- **Language Info**: Node, Python, Rust, Go, etc.
-- **System Info**: OS, hostname, battery
-- **Directory Info**: Current path, duration
-- **Package Info**: Package version when in project
-- **Customizable**: Modules, colors, symbols
-- **Blazing Fast**: Written in Rust
-- **Cross-Shell**: Works with bash, zsh, fish, ion, elvish
-
-## Useful Commands
-- `sc starship self version` - Print version
-- `sc starship prompt print` - Print the prompt
-- `sc starship config print --default` - Print default config
-- `sc starship module explain` - Explain active modules
-- `sc starship session init bash` - Get init code for bash
-
-## Configuration
-Config file: `~/.config/starship.toml`
-
-Example config:
-```toml
-[git_branch]
-symbol = "🌱 "
-
-[git_status]
-conflicted = "⚡️ "
-untracked = "🤷‍ "
-
-[nodejs]
-symbol = "⬢ "
-
-[python]
-symbol = "🐍 "
-```
-
-## Available Modules
-- aws - AWS region/profile
-- gcloud - GCP account
-- kubernetes - Kubernetes context
-- git_branch - Git branch
-- git_commit - Git commit hash
-- git_state - Git operation state
-- git_status - Git status
-- hg_branch - Mercurial branch
-- docker - Docker context
-- golang - Go version
-- nodejs - Node.js version
-- python - Python version
-- ruby - Ruby version
-- rust - Rust version
-- And many more...
-
-## Requirements
-- Shell (bash, zsh, fish, ion, elvish)
-- Terminal with color support
-
-## Tips
-- Customize symbols for your preference
-- Disable unused modules for speed
-- Use `starship explain` to debug
-- Check docs for all module options
+Follow install-guidance.json for setup instructions.
 
 ## Resources
-- Website: https://starship.rs
-- GitHub: https://github.com/starship/starship
+
+- GitHub repository link in plugin source

package/plugins/stripe/install-guidance.json

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

package/plugins/stripe/meta.json

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

package/plugins/structopt/install-guidance.json

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

package/plugins/structopt/meta.json

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

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

@@ -0,0 +1 @@
+# structopt

package/plugins/superpowers/install-guidance.json

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

package/plugins/superpowers/meta.json

@@ -0,0 +1,7 @@
+{
+  "description": "Agentic skills framework for software development methodology from obra/superpowers",
+  "tags": [
+    "superpowers"
+  ],
+  "has_learn": false
+}

package/plugins/svg-term/install-guidance.json

@@ -0,0 +1,12 @@
+{
+  "plugin": "svg-term",
+  "binary": "svg-term",
+  "check": "svg-term --version",
+  "install_steps": [
+    "npm install -g svg-term-cli",
+    "# Optional: Install asciinema for recording",
+    "brew install asciinema  # macOS",
+    "# apt install asciinema  # Ubuntu/Debian"
+  ],
+  "note": "For recording new sessions, install asciinema separately. Can also convert existing asciinema recordings."
+}

package/plugins/svg-term/meta.json

@@ -0,0 +1,9 @@
+{
+  "description": "Share terminal sessions via SVG and CSS. Create animated terminal recordings that can be embedded in READMEs, blogs, and documentation",
+  "tags": ["terminal", "svg", "recording", "documentation", "asciinema", "nodejs"],
+  "has_learn": true,
+  "homepage": "https://github.com/marionebl/svg-term-cli",
+  "source": "https://github.com/marionebl/svg-term-cli",
+  "stars": 4207,
+  "language": "nodejs"
+}

package/plugins/svg-term/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "svg-term",
+  "description": "Share terminal sessions via animated SVG and CSS",
+  "version": "1.0.0",
+  "binary": "svg-term",
+  "check": "svg-term --version",
+  "install": {
+    "method": "npm",
+    "command": "npm install -g svg-term-cli"
+  },
+  "commands": {
+    "cast": {
+      "command": "svg-term --cast {cast_id}",
+      "description": "Generate SVG from asciinema cast ID",
+      "args": ["cast_id"]
+    },
+    "file": {
+      "command": "svg-term --in {file} --out {output}",
+      "description": "Generate SVG from local cast file",
+      "args": ["file", "output"]
+    },
+    "record": {
+      "command": "asciinema rec demo.cast",
+      "description": "Record terminal session (requires asciinema)"
+    }
+  }
+}

package/plugins/svg-term/skills/quickstart/SKILL.md

@@ -0,0 +1,66 @@
+# SVG Term Quickstart
+
+Create beautiful animated SVG recordings of terminal sessions.
+
+## Installation
+
+```bash
+npm install -g svg-term-cli
+
+# Optional: Install asciinema for recording
+brew install asciinema  # macOS
+```
+
+## Basic Workflow
+
+### 1. Record Terminal Session
+
+```bash
+# Start recording
+asciinema rec demo.cast
+
+# Do your terminal work...
+
+# Stop recording (Ctrl+D or type 'exit')
+```
+
+### 2. Convert to SVG
+
+```bash
+# From local file
+svg-term --in demo.cast --out demo.svg
+
+# From asciinema.org (replace CAST_ID with actual ID)
+svg-term --cast CAST_ID --out demo.svg
+```
+
+## Styling Options
+
+```bash
+# Set window frame style
+svg-term --in demo.cast --out demo.svg --window
+
+# Set theme
+svg-term --in demo.cast --out demo.svg --theme monokai
+
+# Available themes: dracula, monokai, solarized-dark, etc.
+```
+
+## Embedding
+
+The generated SVG can be:
+- Embedded directly in README.md
+- Used in blog posts
+- Added to documentation
+- Viewed in any modern browser
+
+```markdown
+![Demo](demo.svg)
+```
+
+## Tips
+
+- Keep recordings short for smaller file sizes
+- Use `--window` flag for a realistic terminal frame
+- Test different themes for better contrast
+- Consider using `--padding` for breathing room

package/plugins/tcsh/install-guidance.json

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

package/plugins/tcsh/meta.json

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

package/plugins/tcsh/plugin.json

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

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

@@ -0,0 +1 @@
+# tcsh

package/plugins/telegraf/install-guidance.json

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

package/plugins/telegraf/meta.json

@@ -0,0 +1 @@
+{"description":"telegraf is a metrics collector by InfluxData. Collects system metrics, application performance data, and sends to monitoring backends (Prometheus, InfluxDB, Datadog, etc.).","tags":["telegraf","metrics","monitoring","observability","influxdb"],"has_learn":true}

package/plugins/telegraf/plugin.json

@@ -0,0 +1 @@
+{"name":"telegraf","version":"0.1.0","description":"telegraf — metrics collector for system, app, and service monitoring","source":"https://github.com/influxdata/telegraf","checks":[{"type":"binary","name":"telegraf"}],"install_guidance":{"plugin":"telegraf","binary":"telegraf","check":"which telegraf","install_steps":["brew install telegraf","Verify: telegraf --version","supercli plugins install ./plugins/telegraf --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"telegraf","resource":"self","action":"version","description":"Print telegraf version","adapter":"process","adapterConfig":{"command":"telegraf","baseArgs":["--version"],"missingDependencyHelp":"Install: brew install telegraf"},"args":[]},{"namespace":"telegraf","resource":"config","action":"generate","description":"Generate sample configuration","adapter":"process","adapterConfig":{"command":"telegraf","baseArgs":["--sample"],"timeout_ms":10000,"missingDependencyHelp":"Install telegraf"},"args":[]},{"namespace":"telegraf","resource":"_","action":"_","description":"Passthrough to telegraf CLI","adapter":"process","adapterConfig":{"command":"telegraf","passthrough":true,"missingDependencyHelp":"Install telegraf"},"args":[]}]}

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

@@ -0,0 +1,17 @@
+# Quickstart
+
+See GitHub repository for full documentation.
+
+## Installation
+
+```bash
+# See install-guidance.json
+```
+
+## Basic Usage
+
+Refer to the tool's official documentation.
+
+## Resources
+
+- GitHub repository in plugin source

package/plugins/terraform/install-guidance.json

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

package/plugins/terraform/meta.json

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

package/plugins/terraformer/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "terraformer",
+  "binary": "terraformer",
+  "check": "which terraformer",
+  "install_steps": [
+    "brew install terraformer",
+    "Verify: terraformer --version",
+    "supercli plugins install ./plugins/terraformer --on-conflict replace --json"
+  ],
+  "note": "Also available via: apt, scoop, or download from GitHub releases. Requires provider credentials (AWS keys, GCP service account, etc.)."
+}

package/plugins/terraformer/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "terraformer — generate Terraform files from existing infrastructure. AWS, GCP, GitHub, and 20+ provider support.",
+  "tags": ["terraformer", "terraform", "iac", "infrastructure", "google", "cli"],
+  "has_learn": true
+}

package/plugins/terraformer/plugin.json

@@ -0,0 +1,104 @@
+{
+  "name": "terraformer",
+  "version": "0.1.0",
+  "description": "terraformer — generate Terraform files from existing infrastructure",
+  "source": "https://github.com/GoogleCloudPlatform/terraformer",
+  "checks": [
+    { "type": "binary", "name": "terraformer" }
+  ],
+  "install_guidance": {
+    "plugin": "terraformer",
+    "binary": "terraformer",
+    "check": "which terraformer",
+    "install_steps": [
+      "brew install terraformer",
+      "Verify: terraformer --version",
+      "supercli plugins install ./plugins/terraformer --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "terraformer",
+      "resource": "self",
+      "action": "version",
+      "description": "Print terraformer version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "terraformer",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install terraformer: brew install terraformer"
+      },
+      "args": []
+    },
+    {
+      "namespace": "terraformer",
+      "resource": "import",
+      "action": "aws",
+      "description": "Import AWS resources into Terraform",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "terraformer",
+        "baseArgs": ["import", "aws"],
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install terraformer"
+      },
+      "args": [
+        { "name": "resources", "type": "string", "required": true, "description": "Comma-separated resources (e.g., 'vpc,ec2,s3')" },
+        { "name": "regions", "type": "string", "required": false, "description": "AWS regions (e.g., 'us-east-1,us-west-2')" }
+      ]
+    },
+    {
+      "namespace": "terraformer",
+      "resource": "import",
+      "action": "gcp",
+      "description": "Import GCP resources into Terraform",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "terraformer",
+        "baseArgs": ["import", "gcp"],
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install terraformer"
+      },
+      "args": [
+        { "name": "resources", "type": "string", "required": true, "description": "Comma-separated resources (e.g., 'compute,storage')" },
+        { "name": "projects", "type": "string", "required": false, "description": "GCP project ID" }
+      ]
+    },
+    {
+      "namespace": "terraformer",
+      "resource": "import",
+      "action": "github",
+      "description": "Import GitHub resources into Terraform",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "terraformer",
+        "baseArgs": ["import", "github"],
+        "passthrough": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Install terraformer"
+      },
+      "args": [
+        { "name": "organizations", "type": "string", "required": false, "description": "GitHub organization" },
+        { "name": "token", "type": "string", "required": false, "description": "GitHub token" }
+      ]
+    },
+    {
+      "namespace": "terraformer",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to terraformer CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "terraformer",
+        "passthrough": true,
+        "missingDependencyHelp": "Install terraformer"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,42 @@
+---
+name: terraformer
+description: Use this skill when the user wants to generate Terraform configs from existing cloud infrastructure, import AWS/GCP resources, or reverse-engineer IaC from live resources.
+---
+
+# terraformer Plugin
+
+Generate Terraform files from existing infrastructure.
+
+## Commands
+
+### Import
+- `terraformer import aws` — Import AWS resources into Terraform
+- `terraformer import gcp` — Import GCP resources into Terraform
+- `terraformer import github` — Import GitHub resources into Terraform
+
+## Usage Examples
+- "Import my AWS VPC and EC2 into Terraform"
+- "Generate Terraform configs from GCP"
+- "Import GitHub repositories into Terraform state"
+
+## Installation
+
+```bash
+brew install terraformer
+```
+
+## Examples
+
+```bash
+# Import AWS resources
+terraformer import aws --resources=vpc,ec2,sg --regions=us-east-1
+
+# Import GCP resources
+terraformer import gcp --resources=compute,storage --projects=my-project
+
+# Import GitHub
+terraformer import github --organizations=my-org --token=ghp_xxx
+
+# List supported resources
+terraformer import aws list
+```

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

@@ -0,0 +1,11 @@
+{
+  "plugin": "tg-cli",
+  "binary": "tg",
+  "check": "which tg",
+  "install_steps": [
+    "uv tool install kabi-tg-cli",
+    "Verify: tg --version",
+    "supercli plugins install ./plugins/tg-cli --on-conflict replace --json"
+  ],
+  "note": "Requires Telegram API credentials. Set TG_API_ID and TG_API_HASH env vars, or uses Telegram Desktop default (api_id=2040). Requires Python 3.10+ and uv/pipx."
+}

package/plugins/tg-cli/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "tg-cli — Telegram CLI for local-first sync, search, export via MTProto. Syncs messages into local SQLite for fast agent-friendly retrieval with --json or --yaml output.",
+  "tags": ["tg-cli", "telegram", "messaging", "chat", "mtproto", "cli", "python"],
+  "has_learn": true
+}

package/plugins/tg-cli/plugin.json

@@ -0,0 +1,128 @@
+{
+  "name": "tg-cli",
+  "version": "0.1.0",
+  "description": "tg-cli — Telegram CLI for local-first sync, search, export via MTProto with JSON/YAML output",
+  "source": "https://github.com/public-clis/tg-cli",
+  "checks": [
+    { "type": "binary", "name": "tg" }
+  ],
+  "install_guidance": {
+    "plugin": "tg-cli",
+    "binary": "tg",
+    "check": "which tg",
+    "install_steps": [
+      "uv tool install kabi-tg-cli",
+      "Verify: tg --version",
+      "supercli plugins install ./plugins/tg-cli --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "tg-cli",
+      "resource": "self",
+      "action": "version",
+      "description": "Print tg-cli version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install tg-cli: uv tool install kabi-tg-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "self",
+      "action": "status",
+      "description": "Check account and sync status",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["status", "--yaml"],
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "chats",
+      "action": "list",
+      "description": "List Telegram chats",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["chats", "--yaml"],
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "search",
+      "action": "run",
+      "description": "Search messages by keyword",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["search"],
+        "positionalArgs": ["query"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Search keyword or regex" }
+      ]
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "recent",
+      "action": "list",
+      "description": "List recent messages",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["recent", "--yaml"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": [
+        { "name": "hours", "type": "string", "required": false, "description": "Hours to look back (e.g., 24)" },
+        { "name": "limit", "type": "string", "required": false, "description": "Max messages" }
+      ]
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "refresh",
+      "action": "run",
+      "description": "Refresh local Telegram cache",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "baseArgs": ["refresh", "--yaml"],
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "tg-cli",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to tg CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "tg",
+        "passthrough": true,
+        "missingDependencyHelp": "Install tg-cli"
+      },
+      "args": []
+    }
+  ]
+}