superacli 1.1.6 → 1.1.7

package/plugins/cocoindex-code/scripts/query.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+
+import argparse
+import asyncio
+import json
+import os
+import sys
+
+
+def parse_csv_list(value):
+    if not value:
+        return None
+    items = [item.strip() for item in value.split(",") if item.strip()]
+    return items or None
+
+
+async def main_async(args):
+    root = os.path.abspath(
+        args.root or os.environ.get("SUPERCLI_INVOKE_CWD") or os.getcwd()
+    )
+    os.environ["COCOINDEX_CODE_ROOT_PATH"] = root
+
+    from cocoindex_code.indexer import app as indexer_app
+    from cocoindex_code.query import query_codebase
+
+    if args.refresh_index:
+        await indexer_app.update(report_to_stdout=False)
+
+    results = await query_codebase(
+        query=args.query,
+        limit=args.limit,
+        offset=args.offset,
+        languages=parse_csv_list(args.languages),
+        paths=parse_csv_list(args.paths),
+    )
+
+    payload = {
+        "success": True,
+        "root": root,
+        "query": args.query,
+        "total_returned": len(results),
+        "offset": args.offset,
+        "results": [
+            {
+                "file_path": item.file_path,
+                "language": item.language,
+                "content": item.content,
+                "start_line": item.start_line,
+                "end_line": item.end_line,
+                "score": item.score,
+            }
+            for item in results
+        ],
+    }
+    print(json.dumps(payload))
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(description="Query cocoindex-code directly")
+    parser.add_argument("--query", required=True)
+    parser.add_argument("--limit", type=int, default=5)
+    parser.add_argument("--offset", type=int, default=0)
+    parser.add_argument("--root")
+    parser.add_argument("--languages")
+    parser.add_argument("--paths")
+    parser.add_argument("--refresh-index", action="store_true")
+    return parser
+
+
+def main():
+    parser = build_parser()
+    args = parser.parse_args()
+    try:
+        asyncio.run(main_async(args))
+    except Exception as err:
+        print(
+            json.dumps(
+                {
+                    "success": False,
+                    "message": str(err),
+                }
+            )
+        )
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/plugins/cocoindex-code/scripts/run-query.js

@@ -0,0 +1,50 @@
+const fs = require("fs")
+const path = require("path")
+const { spawnSync } = require("child_process")
+
+function resolvePythonFromLauncher() {
+  const which = spawnSync("which", ["cocoindex-code"], { encoding: "utf-8", timeout: 3000 })
+  if (which.error || which.status !== 0) {
+    throw new Error("Could not locate 'cocoindex-code' in PATH")
+  }
+
+  const launcher = (which.stdout || "").trim()
+  const firstLine = fs.readFileSync(launcher, "utf-8").split("\n", 1)[0] || ""
+  if (!firstLine.startsWith("#!")) {
+    throw new Error("Could not resolve cocoindex-code Python interpreter from launcher")
+  }
+
+  return firstLine.slice(2).trim()
+}
+
+function run() {
+  const python = resolvePythonFromLauncher()
+  const script = path.resolve(__dirname, "query.py")
+  const args = process.argv.slice(2)
+  const result = spawnSync(python, [script, ...args], {
+    encoding: "utf-8",
+    timeout: 300000,
+    env: process.env,
+  })
+
+  if (result.error) {
+    throw result.error
+  }
+
+  if (result.stdout) process.stdout.write(result.stdout)
+  if (result.status !== 0) {
+    if (result.stderr) process.stderr.write(result.stderr)
+    process.exit(result.status || 1)
+  }
+}
+
+if (require.main === module) {
+  try {
+    run()
+  } catch (err) {
+    process.stderr.write(err.message)
+    process.exit(1)
+  }
+}
+
+module.exports = { run, resolvePythonFromLauncher }

package/plugins/cocoindex-code/skills/quickstart/SKILL.md

@@ -0,0 +1,73 @@
+---
+skill_name: cocoindex-code.quickstart
+description: Install cocoindex-code, auto-register MCP via supercli plugin install, then prefer the fast direct search capability for repository search; keep MCP search for MCP-native flows.
+tags: cocoindex,mcp,semantic-search,code,agents
+---
+
+# cocoindex-code Quickstart
+
+Use this when you need semantic code search over a repository via SuperCLI.
+
+Prefer `supercli cocoindex code search` for normal bot and human usage. It is the easiest and fastest path.
+
+## 1) Install upstream binary
+
+```bash
+pipx install cocoindex-code
+# or
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
+```
+
+## 2) Install plugin (auto MCP registration)
+
+```bash
+supercli plugins learn cocoindex-code
+supercli plugins install cocoindex-code --json
+```
+
+This creates MCP server `cocoindex-code` (if missing) and binds capabilities `cocoindex.code.search` and `cocoindex.mcp.search`.
+
+## 3) Build index once (recommended)
+
+```bash
+supercli cocoindex index build --json
+```
+
+For small repos this is optional; indexing can happen on first search.
+
+## 4) Preferred search flow (humans and bots)
+
+```bash
+supercli cocoindex code search --query "how are sessions stored" --limit 5 --json
+supercli cocoindex code search --query "error handling middleware" --offset 5 --json
+supercli cocoindex code search --query "entrypoint reads process.argv rawArgs and parses flags" --paths "cli/*" --limit 5 --json
+```
+
+`cocoindex code search` runs directly against the installed `cocoindex-code` package, so it avoids MCP server startup overhead and targets the current repo by default.
+
+## 5) MCP-native search (optional)
+
+```bash
+supercli cocoindex mcp search --query "how are sessions stored" --limit 5 --json
+```
+
+Use this only when you explicitly need MCP-native execution.
+
+## 6) Advanced search with language/path filters
+
+```bash
+supercli mcp call --mcp-server cocoindex-code --tool search --input-json '{"query":"database connection","languages":["typescript"],"paths":["src/*"],"limit":10}' --timeout-ms 180000 --json
+```
+
+## Optional Configuration
+
+```bash
+export COCOINDEX_CODE_ROOT_PATH=/path/to/repo
+export COCOINDEX_CODE_EMBEDDING_MODEL=sbert/nomic-ai/CodeRankEmbed
+```
+
+`COCOINDEX_CODE_EXCLUDED_PATTERNS` expects a JSON array string, for example:
+
+```bash
+export COCOINDEX_CODE_EXCLUDED_PATTERNS='["**/generated/**","**/*.snap"]'
+```

package/plugins/copilot/README.md

@@ -0,0 +1,24 @@
+# Copilot Plugin
+
+`copilot` wraps GitHub Copilot CLI for scriptable, non-interactive workflows in supercli.
+
+## Install
+
+```bash
+supercli plugins install copilot --json
+npm install -g @github/copilot
+```
+
+## Commands
+
+- `supercli copilot cli version`
+- `supercli copilot task ask --prompt "..."`
+- `supercli copilot task ask-json --prompt "..."`
+- `supercli copilot <any upstream args...>`
+
+## Notes
+
+- `task ask` runs prompt mode with default Copilot output.
+- `task ask-json` is a compatibility alias that currently runs non-stream text mode (`--stream off`) because the installed CLI build does not expose JSON output flags.
+- Login and plan entitlements are required before automation (`copilot login`).
+- Wrapper commands do not force permissive tool flags; use passthrough for advanced autonomy controls.

package/plugins/copilot/plugin.json

@@ -0,0 +1,80 @@
+{
+  "name": "copilot",
+  "version": "0.1.0",
+  "description": "GitHub Copilot CLI plugin with programmatic wrappers and passthrough",
+  "source": "https://docs.github.com/copilot/how-tos/copilot-cli/cli-getting-started",
+  "checks": [
+    { "type": "binary", "name": "copilot" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "copilot",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show installed Copilot CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "copilot",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Install with: npm install -g @github/copilot"
+      },
+      "args": []
+    },
+    {
+      "namespace": "copilot",
+      "resource": "task",
+      "action": "ask",
+      "description": "Run a programmatic Copilot prompt and return text-only response",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "copilot",
+        "baseArgs": [],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @github/copilot"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Prompt to run in programmatic mode" },
+        { "name": "model", "type": "string", "required": false, "description": "Model id (optional)" }
+      ]
+    },
+    {
+      "namespace": "copilot",
+      "resource": "task",
+      "action": "ask-json",
+      "description": "Run a programmatic Copilot prompt with non-stream text output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "copilot",
+        "baseArgs": ["--stream", "off"],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @github/copilot"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Prompt to run in programmatic mode" },
+        { "name": "model", "type": "string", "required": false, "description": "Model id (optional)" },
+        { "name": "agent", "type": "string", "required": false, "description": "Custom agent to use" }
+      ]
+    },
+    {
+      "namespace": "copilot",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Copilot CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "copilot",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @github/copilot"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+---
+skill_name: copilot.quickstart
+description: Agent workflow for running GitHub Copilot CLI in non-interactive programmatic mode.
+tags: copilot,github,ai,automation,headless
+---
+
+# copilot Quickstart
+
+Use this when you need GitHub Copilot CLI for scripted prompts and machine-readable outputs.
+
+## 1) Install plugin and dependency
+
+```bash
+supercli plugins learn copilot
+supercli plugins install copilot --json
+npm install -g @github/copilot
+```
+
+## 2) Login and validate setup
+
+```bash
+copilot login
+supercli copilot cli version
+```
+
+## 3) Programmatic usage
+
+```bash
+supercli copilot task ask --prompt "Summarize the current branch changes"
+supercli copilot task ask-json --prompt "List top risks in this PR"
+```
+
+## 4) Full passthrough for advanced flags
+
+```bash
+supercli copilot -p "Explain this module" --output-format json
+supercli copilot -p "Draft a migration plan" --agent my-agent --output-format json
+```
+
+## 5) Caveats
+
+- Current Copilot CLI build in this environment does not expose JSON output flags; `task ask-json` runs in non-stream text mode (`--stream off`).
+- Copilot may require repository trust and auth setup on first run.
+- Keep tool permissions explicit for automation; use passthrough to set advanced `--allow-*` options when needed.

package/plugins/gemini/README.md

@@ -0,0 +1,24 @@
+# Gemini Plugin
+
+`gemini` wraps the Gemini CLI for agent-safe, non-interactive usage in supercli.
+
+## Install
+
+```bash
+supercli plugins install gemini --json
+npm install -g @google/gemini-cli
+```
+
+## Commands
+
+- `supercli gemini cli version`
+- `supercli gemini task text --prompt "..."`
+- `supercli gemini task ask --prompt "..."`
+- `supercli gemini task stream --prompt "..."`
+- `supercli gemini <any upstream args...>`
+
+## Notes
+
+- `task ask` uses `--output-format json`.
+- `task stream` uses `--output-format stream-json` and emits JSONL events.
+- For unattended automation, prefer API-key auth (`GEMINI_API_KEY`) instead of interactive login.

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" }
+      ]
+    }
+  ]
+}