superacli 1.1.6 → 1.1.7

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

@@ -0,0 +1,46 @@
+# Coding Agent Session Search (cass) Skill
+
+Search across your local coding agent history (Codex, Claude Code, Gemini CLI, Cline, Cursor, Aider, etc.) to reuse past solutions and debugging context.
+
+## Quick Start
+
+### 1. Setup
+Install `cass` and verify installation:
+```bash
+dcli cass cli setup
+```
+
+### 2. Index History
+Rebuild the search index to include recent sessions:
+```bash
+dcli cass index run --full
+```
+
+### 3. Search Across Sessions
+Search for specific errors or implementation patterns:
+```bash
+dcli cass search run --query "authentication error in react" --limit 5
+```
+
+### 4. View Session Context
+Once you find a hit, view the conversation detail:
+```bash
+dcli cass session view --path /path/to/session.jsonl --line-number 42
+```
+
+Or expand context around the hit:
+```bash
+dcli cass session expand --path /path/to/session.jsonl --line-number 42 --context 5
+```
+
+### 5. Check Activity
+See statistics about your agent usage:
+```bash
+dcli cass activity stats
+```
+
+## Tips for Agents
+- **Robot Mode**: This plugin always uses `--robot` or `--json` to ensure clean, parseable output.
+- **Cross-Agent Knowledge**: Use `cass` to find how *other* agents solved similar problems in this or other codebases.
+- **Index Freshness**: If results seem outdated, run `dcli cass index run` to update the index.
+- **Semantic Search**: If the `cass` binary is configured with model files, you can use `--mode semantic` or `--mode hybrid` for better conceptual matches.

package/plugins/clever/README.md

@@ -0,0 +1,46 @@
+# Clever Plugin
+
+Agent-friendly SuperCLI integration for Clever Tools (`clever`), focused on non-interactive account and platform workflows.
+
+## Why This Plugin
+
+Clever Tools already supports two strong automation primitives:
+
+- non-interactive auth via `CLEVER_TOKEN` and `CLEVER_SECRET`
+- structured output via `--format json` / `-F json`
+
+This plugin packages those capabilities into stable SuperCLI commands.
+
+## Setup
+
+```bash
+dcli clever cli setup
+```
+
+Authentication can be provided either by:
+
+- exported `CLEVER_TOKEN` and `CLEVER_SECRET`
+- a prior `clever login`
+
+## Commands
+
+- `clever cli setup`: install `clever-tools`
+- `clever cli doctor`: run `clever diag --format json`
+- `clever auth whoami`: return the active profile as JSON
+- `clever apps list`: list applications as JSON
+- `clever addons list`: list add-ons as JSON
+- `clever tokens list`: list API bridge tokens as JSON
+- `clever _ _`: passthrough to raw Clever CLI commands
+
+## Notes
+
+- stdout should remain JSON-only for wrapped commands
+- use `CLEVER_TOKEN` and `CLEVER_SECRET` in CI rather than interactive login
+- prefer the wrapped commands first; use passthrough for advanced or newer Clever CLI surfaces
+
+## Skills
+
+- `plugins/clever/skills/quickstart/SKILL.md`
+- `plugins/clever/skills/auth-and-profile.md`
+- `plugins/clever/skills/resource-inventory.md`
+- `plugins/clever/skills/passthrough-safety.md`

package/plugins/clever/plugin.json

@@ -0,0 +1,119 @@
+{
+  "name": "clever",
+  "version": "0.1.0",
+  "description": "Clever Tools CLI plugin with agent-friendly JSON wrappers for Clever Cloud",
+  "source": "https://www.clever.cloud/developers/doc/cli/",
+  "checks": [
+    { "type": "binary", "name": "node" },
+    { "type": "binary", "name": "npm" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "clever",
+      "resource": "cli",
+      "action": "setup",
+      "description": "Install Clever Tools globally",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/setup-clever.js"],
+        "parseJson": false,
+        "timeout_ms": 120000
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "cli",
+      "action": "doctor",
+      "description": "Run Clever environment diagnostics",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "baseArgs": ["diag", "--format", "json"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "auth",
+      "action": "whoami",
+      "description": "Show the active Clever Cloud profile",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "baseArgs": ["profile", "--format", "json"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "apps",
+      "action": "list",
+      "description": "List Clever Cloud applications",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "baseArgs": ["applications", "--format", "json"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "addons",
+      "action": "list",
+      "description": "List Clever Cloud add-ons",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "baseArgs": ["addons", "--format", "json"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "tokens",
+      "action": "list",
+      "description": "List Clever API bridge tokens",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "baseArgs": ["tokens", "--format", "json"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clever",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command for any Clever Tools CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clever",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 60000,
+        "missingDependencyHelp": "Please run 'dcli clever cli setup' to install Clever Tools."
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+const { spawnSync } = require("child_process")
+
+function fail(message, code = 1) {
+  console.error(message)
+  process.exit(code)
+}
+
+function run() {
+  console.log("Installing Clever Tools globally...")
+  const result = spawnSync("npm", ["install", "-g", "clever-tools"], {
+    encoding: "utf-8",
+    stdio: "inherit"
+  })
+
+  if (result.error) {
+    fail(`Failed to start npm: ${result.error.message}`)
+  }
+  if (result.status !== 0) {
+    fail(`npm install failed with exit code ${result.status}`, result.status || 1)
+  }
+
+  console.log("Clever Tools installed.")
+  console.log("Tip: export CLEVER_TOKEN and CLEVER_SECRET for non-interactive use.")
+}
+
+if (require.main === module) {
+  run()
+}

package/plugins/clever/skills/auth-and-profile.md

@@ -0,0 +1,29 @@
+# Clever Auth And Profile Skill
+
+Use this skill when an agent needs to verify Clever Cloud authentication state before performing resource operations.
+
+## Core Checks
+
+Run these first:
+
+```bash
+dcli clever cli doctor
+dcli clever auth whoami
+```
+
+## Non-Interactive Auth Pattern
+
+Prefer environment variables in automation contexts:
+
+```bash
+export CLEVER_TOKEN=...
+export CLEVER_SECRET=...
+```
+
+If tokens are invalid or expired, wrapped commands should fail with a clear rejection message.
+
+## Interpretation Guide
+
+- `doctor` reports runtime and auth state metadata.
+- `whoami` confirms account identity and can be used as a preflight gate.
+- If auth is invalid, stop and request token refresh rather than retrying blindly.

package/plugins/clever/skills/passthrough-safety.md

@@ -0,0 +1,21 @@
+# Clever Passthrough Safety Skill
+
+Use `dcli clever _ _ ...` only when no dedicated wrapper exists.
+
+## Safe Pattern
+
+1. Prefer wrapped commands first (`doctor`, `whoami`, `apps list`, `addons list`, `tokens list`).
+2. If passthrough is required, add `--format json` whenever the target command supports it.
+3. Keep credentials in environment variables instead of command arguments.
+
+## Example
+
+```bash
+dcli clever _ _ applications --format json
+```
+
+## Guardrails
+
+- Do not assume all passthrough subcommands return JSON.
+- Check exit status and error text before continuing dependent actions.
+- Avoid destructive commands unless explicitly required by user intent.

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

@@ -0,0 +1,45 @@
+# Clever Tools Skill
+
+Use the Clever plugin when you need agent-friendly access to Clever Cloud through the `clever` CLI.
+
+## Skill Map
+
+Use these plugin-local skills for specific flows:
+
+- `plugins/clever/skills/auth-and-profile.md`
+- `plugins/clever/skills/resource-inventory.md`
+- `plugins/clever/skills/passthrough-safety.md`
+
+## Quick Start
+
+### 1. Setup
+```bash
+dcli clever cli setup
+```
+
+### 2. Authenticate Non-Interactively
+Prefer environment variables in CI or agent flows:
+
+```bash
+export CLEVER_TOKEN=...
+export CLEVER_SECRET=...
+```
+
+### 3. Inspect Account State
+```bash
+dcli clever auth whoami
+dcli clever cli doctor
+```
+
+### 4. Query Resources
+```bash
+dcli clever apps list
+dcli clever addons list
+dcli clever tokens list
+```
+
+## Agent Notes
+
+- Clever CLI supports JSON output with `--format json`.
+- Wrapped commands are designed to keep stdout parseable.
+- Use passthrough only when a dedicated wrapper does not exist yet.

package/plugins/clever/skills/resource-inventory.md

@@ -0,0 +1,24 @@
+# Clever Resource Inventory Skill
+
+Use this skill to inventory Clever Cloud resources through JSON-first wrappers.
+
+## Recommended Sequence
+
+```bash
+dcli clever auth whoami
+dcli clever apps list
+dcli clever addons list
+dcli clever tokens list
+```
+
+## Why This Sequence
+
+- confirms auth before querying account resources
+- collects app and add-on state for deployment planning
+- inventories API bridge tokens for integration visibility
+
+## Agent Notes
+
+- Keep responses as structured objects; avoid parsing human-formatted output.
+- Treat missing auth as a hard precondition failure.
+- Use passthrough only for commands not yet wrapped by the plugin.

package/plugins/clix/README.md

@@ -1,12 +1,12 @@
 # clix Plugin Harness
 
-This plugin is a hybrid harness for `clix`: it indexes the upstream `SKILL.md` and `README.md` into the local skills catalog and exposes a curated set of safe read-only wrappers.
+This plugin is a hybrid harness for `clix`: it indexes the upstream `SKILL.md` and `README.md` into the local skill-doc catalog and exposes a curated set of safe read-only wrappers.
 
 ## Why This Scope
 
 `clix` can post, delete, like, retweet, and mutate bookmarks using cookie-based auth. The wrapped commands in this plugin intentionally focus on low-risk read-only workflows.
 
-- upstream agent docs are indexed into the skills catalog
+- upstream agent docs are indexed into the skill-doc catalog
 - read-only wrappers are exposed for auth status, timelines, search, tweets, users, and bookmarks
 - no wildcard passthrough in v1
 - no auth mutation, posting, delete, like, retweet, or bookmark mutation wrappers
@@ -17,7 +17,7 @@ This plugin is a hybrid harness for `clix`: it indexes the upstream `SKILL.md` a
 supercli plugins install clix --json
 ```
 
-## Explore Indexed Skills
+## Explore Indexed Skill Documents
 
 ```bash
 supercli skills list --catalog --provider clix --json
@@ -41,4 +41,4 @@ supercli clix bookmarks list --json
 - Wrapped commands always request upstream `--json` output and return parsed data in the dcli envelope.
 - `clix` uses cookie-based auth and may access local browser/session data. Treat that auth state as sensitive.
 - Use upstream `clix` directly for login, account switching, posting, deleting, likes, retweets, and bookmark mutations.
-- Removing the plugin also removes its registered skills provider from the local catalog.
+- Removing the plugin also removes its registered skill-doc provider from the local catalog.

package/plugins/cocoindex-code/README.md

@@ -0,0 +1,64 @@
+# cocoindex-code Plugin Harness
+
+This plugin integrates `cocoindex-code` into supercli with automatic local MCP server registration, a fast direct search capability for day-to-day use, and an MCP-backed search capability for MCP-native workflows.
+
+## What You Get
+
+- auto-registers local MCP server `cocoindex-code`
+- fast capability: `supercli cocoindex code search`
+- MCP capability: `supercli cocoindex mcp search`
+- helper capability: `supercli cocoindex index build`
+- learn content via `supercli plugins learn cocoindex-code`
+
+## Prerequisites
+
+Install `cocoindex-code` first (choose one):
+
+```bash
+pipx install cocoindex-code
+# or
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
+```
+
+Verify binary availability:
+
+```bash
+cocoindex-code --help
+```
+
+## Install Plugin
+
+```bash
+supercli plugins learn cocoindex-code
+supercli plugins install cocoindex-code --json
+```
+
+## Wrapped Capabilities
+
+```bash
+# Build/refresh index first (recommended for large repos)
+supercli cocoindex index build --json
+
+# Preferred for humans and bots: fast semantic code search
+supercli cocoindex code search --query "where is auth middleware implemented" --limit 5 --json
+supercli cocoindex code search --query "session handling" --offset 5 --json
+supercli cocoindex code search --query "entrypoint reads process.argv rawArgs and parses flags" --paths "cli/*" --limit 5 --json
+
+# Optional MCP-native search
+supercli cocoindex mcp search --query "where is auth middleware implemented" --limit 5 --json
+```
+
+## Notes
+
+- Prefer `cocoindex code search` for both humans and non-human agents. It is the fastest, easiest path and searches the current repo directly.
+- `cocoindex code search` uses a direct wrapper around the installed `cocoindex-code` Python package, so it avoids per-query MCP server startup overhead.
+- `cocoindex mcp search` maps to MCP tool `search` on server `cocoindex-code`.
+- Use `cocoindex mcp search` only when you specifically need an MCP-shaped workflow.
+- For advanced MCP input fields such as `languages` or `paths`, use direct MCP call:
+
+```bash
+supercli mcp call --mcp-server cocoindex-code --tool search --input-json '{"query":"auth","languages":["python"],"paths":["src/*"],"limit":5}' --timeout-ms 180000 --json
+```
+
+- By default, cocoindex-code auto-discovers root from `.cocoindex_code/`, `.git/`, or current directory.
+- Optional env vars: `COCOINDEX_CODE_ROOT_PATH`, `COCOINDEX_CODE_EMBEDDING_MODEL`, `COCOINDEX_CODE_EXCLUDED_PATTERNS`.

package/plugins/cocoindex-code/plugin.json

@@ -0,0 +1,81 @@
+{
+  "name": "cocoindex-code",
+  "version": "0.1.0",
+  "description": "Hybrid cocoindex-code plugin: auto-register local MCP server, bind semantic search capability, and add quickstart skill docs",
+  "source": "https://github.com/cocoindex-io/cocoindex-code",
+  "checks": [
+    { "type": "binary", "name": "cocoindex-code" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "post_install": {
+    "script": "scripts/post-install.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "post_uninstall": {
+    "script": "scripts/post-uninstall.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "commands": [
+    {
+      "namespace": "cocoindex",
+      "resource": "code",
+      "action": "search",
+      "description": "Semantic code search via direct cocoindex-code query wrapper",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-query.js"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: uv tool install --upgrade cocoindex-code --prerelease explicit --with \"cocoindex>=1.0.0a24\""
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Natural language query or code snippet" },
+        { "name": "limit", "type": "integer", "required": false, "description": "Maximum results to return" },
+        { "name": "offset", "type": "integer", "required": false, "description": "Pagination offset" },
+        { "name": "languages", "type": "string", "required": false, "description": "Comma-separated language filters" },
+        { "name": "paths", "type": "string", "required": false, "description": "Comma-separated glob path filters" },
+        { "name": "root", "type": "string", "required": false, "description": "Repository root path override" },
+        { "name": "refresh-index", "type": "boolean", "required": false, "description": "Refresh index before search" }
+      ]
+    },
+    {
+      "namespace": "cocoindex",
+      "resource": "mcp",
+      "action": "search",
+      "description": "Semantic code search via cocoindex-code MCP server",
+      "adapter": "mcp",
+      "adapterConfig": {
+        "server": "cocoindex-code",
+        "tool": "search",
+        "mcp_protocol": "jsonrpc",
+        "timeout_ms": 180000
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Natural language query or code snippet" },
+        { "name": "limit", "type": "integer", "required": false, "description": "Maximum results to return" },
+        { "name": "offset", "type": "integer", "required": false, "description": "Pagination offset" },
+        { "name": "refresh_index", "type": "boolean", "required": false, "description": "Refresh index before search" }
+      ]
+    },
+    {
+      "namespace": "cocoindex",
+      "resource": "index",
+      "action": "build",
+      "description": "Build or refresh cocoindex-code local index",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cocoindex-code",
+        "baseArgs": ["index"],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: pipx install cocoindex-code"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/cocoindex-code/scripts/post-install.js

@@ -0,0 +1,61 @@
+const path = require("path")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+const { setMcpServer, listMcpServers } = require("../../../cli/config")
+
+const PLUGIN_NAME = "cocoindex-code"
+const MCP_SERVER_NAME = "cocoindex-code"
+const SKILLS_ROOT = path.resolve(__dirname, "..", "skills")
+
+const DEFAULT_SERVER = {
+  command: "cocoindex-code",
+  args: [],
+  timeout_ms: 180000,
+}
+
+async function ensureMcpServer() {
+  const servers = await listMcpServers()
+  const existing = (servers || []).find((s) => s && s.name === MCP_SERVER_NAME)
+  if (existing) return { server: existing, created: false }
+  await setMcpServer(MCP_SERVER_NAME, DEFAULT_SERVER)
+  return {
+    server: { name: MCP_SERVER_NAME, ...DEFAULT_SERVER },
+    created: true,
+  }
+}
+
+async function run() {
+  const { created } = await ensureMcpServer()
+
+  addProvider({
+    name: PLUGIN_NAME,
+    type: "local_fs",
+    roots: [SKILLS_ROOT],
+    enabled: true,
+  })
+
+  const index = syncCatalog()
+  return {
+    plugin: PLUGIN_NAME,
+    mcp_server: MCP_SERVER_NAME,
+    server_created: created,
+    bound_capabilities: ["cocoindex.code.search", "cocoindex.mcp.search", "cocoindex.index.build"],
+    provider: PLUGIN_NAME,
+    synced_skills: Array.isArray(index.skills) ? index.skills.length : 0,
+  }
+}
+
+if (require.main === module) {
+  run()
+    .then((result) => {
+      process.stdout.write(JSON.stringify(result))
+    })
+    .catch((err) => {
+      process.stderr.write(err.message)
+      process.exit(1)
+    })
+}
+
+module.exports = {
+  run,
+  DEFAULT_SERVER,
+}

package/plugins/cocoindex-code/scripts/post-uninstall.js

@@ -0,0 +1,25 @@
+const { removeProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+async function run() {
+  const removedProvider = removeProvider("cocoindex-code")
+  const index = syncCatalog()
+  return {
+    plugin: "cocoindex-code",
+    removed_provider: removedProvider,
+    synced_skills: Array.isArray(index.skills) ? index.skills.length : 0,
+    note: "MCP server 'cocoindex-code' was not removed automatically. Run: supercli mcp remove cocoindex-code",
+  }
+}
+
+if (require.main === module) {
+  run()
+    .then((result) => {
+      process.stdout.write(JSON.stringify(result))
+    })
+    .catch((err) => {
+      process.stderr.write(err.message)
+      process.exit(1)
+    })
+}
+
+module.exports = { run }