superacli 1.1.6 → 1.1.8

package/plugins/gemini/plugin.json

@@ -0,0 +1,98 @@
+{
+  "name": "gemini",
+  "version": "0.1.0",
+  "description": "Gemini CLI plugin with headless JSON wrappers and passthrough",
+  "source": "https://github.com/google-gemini/gemini-cli",
+  "checks": [
+    { "type": "binary", "name": "gemini" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "gemini",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show installed Gemini CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gemini",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Install with: npm install -g @google/gemini-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "gemini",
+      "resource": "task",
+      "action": "text",
+      "description": "Run a headless Gemini prompt and return text output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gemini",
+        "baseArgs": [],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @google/gemini-cli"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Prompt to run in headless mode" },
+        { "name": "model", "type": "string", "required": false, "description": "Model id (for example gemini-3-pro)" }
+      ]
+    },
+    {
+      "namespace": "gemini",
+      "resource": "task",
+      "action": "ask",
+      "description": "Run a headless Gemini prompt and return structured JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gemini",
+        "baseArgs": ["--output-format", "json"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @google/gemini-cli"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Prompt to run in headless mode" },
+        { "name": "model", "type": "string", "required": false, "description": "Model id (for example gemini-3-pro)" }
+      ]
+    },
+    {
+      "namespace": "gemini",
+      "resource": "task",
+      "action": "stream",
+      "description": "Run a headless Gemini prompt with stream-json events",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gemini",
+        "baseArgs": ["--output-format", "stream-json"],
+        "stream": "jsonl",
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @google/gemini-cli"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Prompt to run in headless mode" },
+        { "name": "model", "type": "string", "required": false, "description": "Model id (for example gemini-3-pro)" }
+      ]
+    },
+    {
+      "namespace": "gemini",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Gemini CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gemini",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @google/gemini-cli"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+---
+skill_name: gemini.quickstart
+description: Agent workflow for running Gemini CLI in deterministic headless mode with JSON outputs.
+tags: gemini,ai,automation,headless,json
+---
+
+# gemini Quickstart
+
+Use this when you need Gemini in scripts or agent workflows without interactive prompts.
+
+## 1) Install plugin and dependency
+
+```bash
+supercli plugins learn gemini
+supercli plugins install gemini --json
+npm install -g @google/gemini-cli
+```
+
+## 2) Validate setup
+
+```bash
+supercli gemini cli version
+```
+
+## 3) Headless modes
+
+```bash
+supercli gemini task text --prompt "Summarize this repository"
+supercli gemini task ask --prompt "Summarize this repository as JSON"
+supercli gemini task stream --prompt "Plan and execute test workflow"
+```
+
+## 4) Full passthrough for upstream flags
+
+```bash
+supercli gemini -p "Explain the architecture" --output-format json
+supercli gemini -p "Run diagnostics" --output-format stream-json
+```
+
+## 5) Caveats
+
+- Prefer non-interactive auth for automation (for example `GEMINI_API_KEY`) to avoid login prompts.
+- `task stream` returns JSONL event lines; consume line-by-line.
+- Use passthrough commands for advanced options not covered by wrappers.

package/plugins/gifcap/plugin.json

@@ -0,0 +1,119 @@
+{
+  "name": "gifcap",
+  "version": "1.0.0",
+  "description": "Screen recording, cropping, and GIF optimization tool",
+  "source": "https://github.com/javimosch/gifcap",
+  "checks": [
+    { "type": "binary", "name": "node" },
+    { "type": "binary", "name": "npm" },
+    { "type": "binary", "name": "ffmpeg" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "gifcap",
+      "resource": "cli",
+      "action": "setup",
+      "description": "Install or link gifcap dependency",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/setup-gifcap.js"],
+        "parseJson": false,
+        "timeout_ms": 120000
+      },
+      "args": []
+    },
+    {
+      "namespace": "gifcap",
+      "resource": "screen",
+      "action": "record",
+      "description": "Record screen and create an optimized GIF or MP4",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gifcap",
+        "baseArgs": ["record"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli gifcap cli setup' to install gifcap."
+      },
+      "args": [
+        { "name": "duration", "type": "number", "required": true, "description": "Duration in seconds to record" },
+        { "name": "output", "alias": "o", "type": "string", "required": false, "description": "Output filename" },
+        { "name": "top", "alias": "t", "type": "number", "required": false, "description": "Crop pixels from top" },
+        { "name": "left", "alias": "l", "type": "number", "required": false, "description": "Crop pixels from left" },
+        { "name": "bottom", "alias": "b", "type": "number", "required": false, "description": "Crop pixels from bottom" },
+        { "name": "right", "alias": "r", "type": "number", "required": false, "description": "Crop pixels from right" },
+        { "name": "speed", "type": "number", "required": false, "description": "Speed multiplier" },
+        { "name": "mp4", "type": "boolean", "required": false, "description": "Output MP4 instead of GIF" },
+        { "name": "quiet", "type": "boolean", "required": false, "description": "Suppress non-essential output", "default": true },
+        { "name": "yes", "type": "boolean", "required": false, "description": "Skip confirmations", "default": true }
+      ]
+    },
+    {
+      "namespace": "gifcap",
+      "resource": "media",
+      "action": "optimize",
+      "description": "Optimize an existing GIF file",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gifcap",
+        "baseArgs": ["optimize"],
+        "positionalArgs": ["input"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli gifcap cli setup' to install gifcap."
+      },
+      "args": [
+        { "name": "input", "type": "string", "required": true, "description": "Path to input GIF" },
+        { "name": "output", "alias": "o", "type": "string", "required": false, "description": "Output filename" },
+        { "name": "target-size", "alias": "ts", "type": "number", "required": false, "description": "Target size in MB" },
+        { "name": "fps", "type": "number", "required": false, "description": "Target FPS" },
+        { "name": "colors", "type": "number", "required": false, "description": "Max colors" },
+        { "name": "yes", "type": "boolean", "required": false, "description": "Skip confirmations", "default": true }
+      ]
+    },
+    {
+      "namespace": "gifcap",
+      "resource": "media",
+      "action": "cut",
+      "description": "Cut seconds from the start/end of a GIF",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gifcap",
+        "baseArgs": ["cut"],
+        "positionalArgs": ["input"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli gifcap cli setup' to install gifcap."
+      },
+      "args": [
+        { "name": "input", "type": "string", "required": true, "description": "Path to input GIF" },
+        { "name": "output", "alias": "o", "type": "string", "required": false, "description": "Output filename" },
+        { "name": "start", "alias": "s", "type": "number", "required": false, "description": "Seconds to cut from start" },
+        { "name": "end", "alias": "e", "type": "number", "required": false, "description": "Seconds to cut from end" }
+      ]
+    },
+    {
+      "namespace": "gifcap",
+      "resource": "media",
+      "action": "convert",
+      "description": "Convert MP4 to GIF",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gifcap",
+        "baseArgs": ["convert"],
+        "positionalArgs": ["input"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli gifcap cli setup' to install gifcap."
+      },
+      "args": [
+        { "name": "input", "type": "string", "required": true, "description": "Path to input MP4" },
+        { "name": "output", "alias": "o", "type": "string", "required": false, "description": "Output filename" }
+      ]
+    }
+  ]
+}

package/plugins/gifcap/scripts/setup-gifcap.js

@@ -0,0 +1,44 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const localRepoPath = '/home/jarancibia/ai/gifcap';
+
+function run(cmd, cwd = process.cwd()) {
+  console.log(`Executing: ${cmd} in ${cwd}`);
+  try {
+    return execSync(cmd, { cwd, stdio: 'inherit' });
+  } catch (e) {
+    console.error(`Failed to execute: ${cmd}`);
+    process.exit(1);
+  }
+}
+
+console.log('--- GifCap Setup ---');
+
+if (fs.existsSync(localRepoPath)) {
+  console.log(`Found local gifcap repository at ${localRepoPath}`);
+  console.log('Linking local repository for development...');
+  
+  // Ensure dependencies are installed in the repo
+  if (!fs.existsSync(path.join(localRepoPath, 'node_modules'))) {
+    console.log('Installing local dependencies...');
+    run('npm install', localRepoPath);
+  }
+  
+  // Link the repo
+  run('npm link', localRepoPath);
+  console.log('Success: Local gifcap linked.');
+} else {
+  console.log('Local repository not found. Installing from npm...');
+  run('npm install -g gifcap');
+}
+
+// Final check
+try {
+  const version = execSync('gifcap --version').toString().trim();
+  console.log(`Verified: gifcap ${version} is available.`);
+} catch (e) {
+  console.error('Error: gifcap binary not found after installation.');
+  process.exit(1);
+}

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

@@ -0,0 +1,34 @@
+# GifCap Skill
+
+Capture your screen, optimize GIFs, and automate media documentation with `gifcap`.
+
+## Quick Start
+
+### 1. Setup
+Install dependencies and link the CLI:
+```bash
+dcli gifcap cli setup
+```
+
+### 2. Automated Recording
+Record 5 seconds of the screen:
+```bash
+dcli gifcap screen record --duration 5 --output recording.gif
+```
+
+### 3. Smart Cropping
+Record a specific area (e.g., center screen or removing bars):
+```bash
+dcli gifcap screen record --duration 10 --top 100 --left 50 --output tutorial.gif
+```
+
+### 4. GIF Optimization
+Reduce file size of an existing GIF to below 2MB:
+```bash
+dcli gifcap media optimize --input large.gif --target-size 2 --output optimized.gif
+```
+
+## Tips for Agents
+- **Non-Interactive Mode**: Always use `--duration` for recording to ensure the process terminates.
+- **JSON Output**: The plugin uses `parseJson: true`, so commands return structured data about the output path and final media metadata.
+- **Cropping**: Use `-t`, `-l`, `-b`, `-r` to focus on the relevant part of the UI.

package/plugins/goose/README.md

@@ -0,0 +1,36 @@
+# Goose Plugin
+
+Use this plugin to run the `goose` CLI through SuperCLI with safer headless defaults.
+
+## Install
+
+```bash
+curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
+supercli plugins install goose
+```
+
+## Fast path
+
+```bash
+supercli goose cli version
+supercli goose task text --text "Summarize this repository"
+supercli goose task json --text "List the main services as JSON"
+supercli goose task stream --text "Plan a docs update"
+supercli goose task file --instructions ./task.txt
+```
+
+These wrapped commands default to `goose run --no-session --quiet` so they work better in CI and other non-interactive automation.
+
+## Passthrough
+
+Use passthrough when you need an upstream flag that is not wrapped yet:
+
+```bash
+supercli goose run --text "Explain this project" --output-format json --no-session
+```
+
+## Notes
+
+- Prefer the wrapped commands for deterministic automation.
+- `task stream` emits JSONL events.
+- `task file` accepts a file path or `-` for stdin.

package/plugins/goose/plugin.json

@@ -0,0 +1,183 @@
+{
+  "name": "goose",
+  "version": "0.1.0",
+  "description": "Goose CLI plugin with headless automation wrappers and passthrough",
+  "source": "https://github.com/block/goose",
+  "checks": [
+    { "type": "binary", "name": "goose" }
+  ],
+  "install_guidance": {
+    "plugin": "goose",
+    "binary": "goose",
+    "check": "goose --version",
+    "install_steps": [
+      "curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash",
+      "goose --version",
+      "supercli plugins install goose"
+    ],
+    "note": "Use headless wrappers with --no-session defaults in CI or other non-interactive workflows."
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "goose",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show installed Goose CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["--version"],
+        "cwd": "invoke_cwd",
+        "parseJson": false,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": []
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "text",
+      "description": "Run a Goose headless task and return text output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "json",
+      "description": "Run a Goose headless task and return structured JSON output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--output-format", "json"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "stream",
+      "description": "Run a Goose headless task with stream-json events",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--output-format", "stream-json"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "stream": "jsonl",
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "file",
+      "description": "Run a Goose headless task from an instructions file",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--instructions"],
+        "cwd": "invoke_cwd",
+        "positionalArgs": ["instructions"],
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "instructions", "type": "string", "required": true, "description": "Instruction file path or - for stdin" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Goose CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+---
+skill_name: goose.quickstart
+description: Agent workflow for running Goose in headless mode with non-interactive defaults and structured output.
+tags: goose,ai,automation,headless,json,jsonl
+---
+
+# Goose Quickstart
+
+Use this when you need Goose in scripts, CI, or agent workflows without interactive prompts.
+
+## 1) Install plugin and dependency
+
+```bash
+curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
+supercli plugins install goose --json
+```
+
+## 2) Validate setup
+
+```bash
+supercli goose cli version
+```
+
+## 3) Headless wrappers
+
+```bash
+supercli goose task text --text "Summarize this repository"
+supercli goose task json --text "Return the top risks in JSON"
+supercli goose task stream --text "Plan a refactor"
+supercli goose task file --instructions ./task.txt
+```
+
+## 4) Passthrough for advanced flags
+
+```bash
+supercli goose run --text "Explain the architecture" --output-format json --no-session
+supercli goose run --instructions ./task.txt --output-format stream-json --no-session
+```
+
+## 5) Caveats
+
+- Wrapped commands include `--no-session` and `--quiet` by default.
+- `task stream` returns JSONL event lines; consume them line by line.
+- Use passthrough for recipes, provider configuration, or flags not covered by wrappers.

package/plugins/json-server/README.md

@@ -0,0 +1,58 @@
+# json-server Plugin Harness
+
+This plugin integrates `@javimosch/json-server` into supercli with agent-friendly background server lifecycle wrappers and full passthrough.
+
+## What You Get
+
+- wrappers for `server start/status/logs/stop`
+- `cli version` wrapper for environment checks
+- full passthrough for all upstream `json-server` commands
+- learn content via `supercli plugins learn json-server`
+
+## Prerequisites
+
+Install the package globally so the `json-server` binary is available:
+
+```bash
+npm install -g @javimosch/json-server
+```
+
+## Install Plugin
+
+```bash
+supercli plugins learn json-server
+supercli plugins install json-server --json
+```
+
+## Wrapper Commands
+
+```bash
+supercli json-server cli version
+supercli json-server server start --file fixtures/db.json --port 43111 --state-dir .json-server-test
+supercli json-server server status --state-dir .json-server-test
+supercli json-server server logs --state-dir .json-server-test --lines 50
+supercli json-server server stop --state-dir .json-server-test
+```
+
+## Full Passthrough Examples
+
+```bash
+supercli json-server server start fixtures/db.json --json
+supercli json-server fixtures/db.json --json --no-interactive --no-color
+```
+
+## Important Caveats
+
+- Prefer wrapper args as flags (`--file`, `--state-dir`) for deterministic invocation.
+- `server start` runs detached and returns immediately; use a short readiness retry loop before API calls.
+- Default state directory is `./.json-server`; isolate environments with `--state-dir` to avoid PID/log collisions.
+- Always run `server stop` after automation flows so stale state does not block future starts.
+
+Example readiness check:
+
+```bash
+for i in 1 2 3 4 5 6 7 8 9 10; do
+  curl -sS http://localhost:43111/posts >/dev/null && break
+  sleep 0.2
+done
+```