superacli 1.1.23 → 1.1.26

package/plugins/toml2json/plugin.json

@@ -0,0 +1,85 @@
+{
+  "name": "toml2json",
+  "version": "0.1.0",
+  "description": "Convert TOML to JSON from stdin or files",
+  "source": "https://github.com/woodruffw/toml2json",
+  "checks": [
+    { "type": "binary", "name": "toml2json" }
+  ],
+  "install_guidance": {
+    "plugin": "toml2json",
+    "binary": "toml2json",
+    "check": "which toml2json",
+    "install_steps": [
+      "cargo install toml2json",
+      "Verify: toml2json --version",
+      "supercli plugins install ./plugins/toml2json --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "toml2json",
+      "resource": "self",
+      "action": "version",
+      "description": "Print toml2json version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "toml2json",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install toml2json: cargo install toml2json"
+      },
+      "args": []
+    },
+    {
+      "namespace": "toml2json",
+      "resource": "convert",
+      "action": "file",
+      "description": "Convert a TOML file to JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "toml2json",
+        "positionalArgs": ["file"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install toml2json"
+      },
+      "args": [
+        { "name": "file", "type": "string", "required": true, "description": "Path to TOML file" }
+      ]
+    },
+    {
+      "namespace": "toml2json",
+      "resource": "convert",
+      "action": "pretty",
+      "description": "Convert TOML to pretty-printed JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "toml2json",
+        "baseArgs": ["--pretty"],
+        "positionalArgs": ["file"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install toml2json"
+      },
+      "args": [
+        { "name": "file", "type": "string", "required": false, "description": "Path to TOML file (reads stdin if omitted)" }
+      ]
+    },
+    {
+      "namespace": "toml2json",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to toml2json CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "toml2json",
+        "passthrough": true,
+        "missingDependencyHelp": "Install toml2json"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+---
+name: toml2json
+description: Use this skill when the user wants to convert TOML files to JSON format, or pipe TOML data through stdin to get JSON output.
+---
+
+# toml2json Plugin
+
+Very small CLI for converting TOML to JSON.
+
+## Commands
+
+### Convert
+- `toml2json convert file` — Convert a TOML file to JSON
+- `toml2json convert pretty` — Convert TOML to pretty-printed JSON
+
+## Usage Examples
+- "Convert a TOML file to JSON"
+- "Pretty-print a TOML configuration as JSON"
+- "Pipe TOML data and convert it"
+
+## Installation
+
+```bash
+cargo install toml2json
+```
+
+## Examples
+
+```bash
+# Convert a file
+toml2json config.toml
+
+# Pretty-print
+toml2json --pretty config.toml
+
+# Pipe from stdin
+cat config.toml | toml2json
+
+# Use with jq
+toml2json config.toml | jq '.key'
+```
+
+## Key Features
+- Convert TOML to JSON
+- Read from files or stdin
+- Pretty-print output option
+- Pipe-friendly for shell workflows

package/plugins/worktrunk/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "worktrunk",
+  "binary": "wt",
+  "check": "which wt",
+  "install_steps": [
+    "cargo install worktrunk",
+    "wt config shell install",
+    "supercli plugins install ./plugins/worktrunk --on-conflict replace --json"
+  ],
+  "note": "Also available via: brew, pacman, winget, conda. Binary name is 'wt'. Shell integration required for cd commands."
+}

package/plugins/worktrunk/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "Git worktree management CLI designed for parallel AI agent workflows. Makes worktrees as easy as branches.",
+  "tags": ["worktrunk", "git", "worktree", "branch", "cli", "rust"],
+  "has_learn": true
+}

package/plugins/worktrunk/plugin.json

@@ -0,0 +1,116 @@
+{
+  "name": "worktrunk",
+  "version": "0.1.0",
+  "description": "CLI for Git worktree management, designed for parallel AI agent workflows",
+  "source": "https://github.com/max-sixty/worktrunk",
+  "checks": [
+    { "type": "binary", "name": "wt" }
+  ],
+  "install_guidance": {
+    "plugin": "worktrunk",
+    "binary": "wt",
+    "check": "which wt",
+    "install_steps": [
+      "cargo install worktrunk",
+      "wt config shell install",
+      "supercli plugins install ./plugins/worktrunk --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "worktrunk",
+      "resource": "self",
+      "action": "version",
+      "description": "Print worktrunk version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install worktrunk: cargo install worktrunk"
+      },
+      "args": []
+    },
+    {
+      "namespace": "worktrunk",
+      "resource": "branch",
+      "action": "switch",
+      "description": "Switch to a worktree branch",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "baseArgs": ["switch"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install worktrunk"
+      },
+      "args": [
+        { "name": "branch", "type": "string", "required": true, "description": "Branch name to switch to" }
+      ]
+    },
+    {
+      "namespace": "worktrunk",
+      "resource": "branch",
+      "action": "create",
+      "description": "Create and switch to a new worktree branch",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "baseArgs": ["switch", "-c"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install worktrunk"
+      },
+      "args": [
+        { "name": "branch", "type": "string", "required": true, "description": "New branch name" }
+      ]
+    },
+    {
+      "namespace": "worktrunk",
+      "resource": "branch",
+      "action": "list",
+      "description": "List all worktree branches",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "baseArgs": ["list"],
+        "passthrough": true,
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install worktrunk"
+      },
+      "args": []
+    },
+    {
+      "namespace": "worktrunk",
+      "resource": "branch",
+      "action": "remove",
+      "description": "Remove a worktree branch",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "baseArgs": ["remove"],
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install worktrunk"
+      },
+      "args": [
+        { "name": "branch", "type": "string", "required": false, "description": "Branch name to remove (uses current if omitted)" }
+      ]
+    },
+    {
+      "namespace": "worktrunk",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to wt CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wt",
+        "passthrough": true,
+        "missingDependencyHelp": "Install worktrunk"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,62 @@
+---
+name: worktrunk
+description: Use this skill when the user wants to manage Git worktrees, switch between parallel branches, or work with multiple worktrees.
+---
+
+# worktrunk Plugin
+
+CLI for Git worktree management, designed for parallel AI agent workflows.
+
+## Commands
+
+### Branch
+- `worktrunk branch switch` — Switch to a worktree branch
+- `worktrunk branch create` — Create and switch to a new worktree branch
+- `worktrunk branch list` — List all worktree branches
+- `worktrunk branch remove` — Remove a worktree branch
+
+## Usage Examples
+- "Switch to a different worktree branch"
+- "Create a new worktree for a feature branch"
+- "List all my worktrees"
+- "Remove a worktree I no longer need"
+
+## Installation
+
+```bash
+cargo install worktrunk
+wt config shell install
+```
+
+## Examples
+
+```bash
+# Switch to existing branch
+wt switch feature-branch
+
+# Create and switch to new branch
+wt switch -c new-feature
+
+# Create with external tool execution
+wt switch -c -x claude new-feature
+
+# List all worktrees
+wt list
+
+# Remove current worktree
+wt remove
+
+# Remove specific worktree
+wt remove old-branch
+
+# Checkout PR
+wt switch pr:123
+```
+
+## Key Features
+- Branch-name based worktree addressing
+- Automatic path computation
+- Hooks for workflow automation
+- LLM commit message generation
+- PR checkout support
+- Build cache sharing between worktrees

package/server/app.js

@@ -15,6 +15,8 @@ const jobsRouter = require("./routes/jobs");
 const askRouter = require("./routes/ask");
 const pluginsRouter = require("./routes/plugins");
 const docsRouter = require("./routes/docs");
+const settingsRouter = require("./routes/settings");
+const clientsRouter = require("./routes/clients");
 
 const PORT = process.env.PORT || 3000;
 
@@ -34,7 +36,6 @@ app.use("/docs", express.static(path.join(__dirname, "../docs")));
 // API routes (with authentication)
 app.use("/api/dashboard", requireAuth, dashboardRouter);
 app.use("/api/adapters", requireAuth, adaptersRouter);
-app.use("/api/config", requireAuth, configRouter);
 app.use("/api/commands", requireAuth, commandsRouter);
 app.use("/api/specs", requireAuth, specsRouter);
 app.use("/api/mcp", requireAuth, mcpRouter);
@@ -43,9 +44,9 @@ app.use("/api/jobs", requireAuth, jobsRouter);
 app.use("/api/ask", requireAuth, askRouter);
 app.use("/api/plugins", pluginsRouter);
 app.use("/api/docs", requireAuth, docsRouter);
-
-// Tree/command endpoints under /api (config router handles them)
-app.use("/api", requireAuth, configRouter);
+app.use("/api/clients", requireAuth, clientsRouter);
+app.use("/api", settingsRouter);
+app.use("/api/config", requireAuth, configRouter);
 
 app.use("/", dashboardRouter);
 

package/server/middleware/auth.js

@@ -38,10 +38,9 @@ async function requireAuth(req, res, next) {
       return next();
     }
 
-    // Allow settings and API keys endpoints when no API keys exist (bootstrapping)
-    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : [];
-    const fullPath = (req.baseUrl || "") + (req.path || "");
-    if (apiKeys.length === 0 && (fullPath.includes("/settings") || fullPath.includes("/api-keys"))) {
+    // Allow HTML views (browser navigation) without auth
+    // This allows users to navigate the UI without API keys
+    if (req.accepts("html") && !req.headers["x-requested-with"] && req.query.format !== "json") {
       return next();
     }
 
@@ -52,6 +51,7 @@ async function requireAuth(req, res, next) {
     }
 
     // Validate API key against stored keys
+    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : [];
     const isValid = apiKeys.some(k => k.key === apiKey);
 
     if (!isValid) {

package/server/routes/clients.js

@@ -0,0 +1,46 @@
+const { Router } = require("express");
+const { getStorage } = require("../storage/adapter");
+const { requireAuth } = require("../middleware/auth");
+
+const router = Router();
+
+// Helper function to handle errors
+function handleError(res, err) {
+  console.error(err);
+  const status = err.status || 500;
+  const error = err.error || { code: 500, type: "internal_error", message: err.message || "Internal server error" };
+  res.status(status).json({ error });
+}
+
+// List clients endpoint
+router.get("/", requireAuth, async (req, res) => {
+  try {
+    const storage = getStorage();
+    const clientKeys = await storage.listKeys("client:");
+    const clients = [];
+    
+    for (const key of clientKeys) {
+      try {
+        const client = await storage.get(key);
+        if (client && client.client_id) {
+          clients.push(client);
+        }
+      } catch (err) {
+        // Skip if client read fails
+      }
+    }
+    
+    // Sort by last_seen descending
+    clients.sort((a, b) => new Date(b.last_seen) - new Date(a.last_seen));
+    
+    if (req.query.format !== "json" && req.accepts("html") && !req.xhr && !req.headers["x-requested-with"]) {
+      return res.render("clients", { clients });
+    }
+    
+    res.json({ clients });
+  } catch (err) {
+    handleError(res, err);
+  }
+});
+
+module.exports = router;

package/server/routes/plugins.js

@@ -164,42 +164,6 @@ router.get("/", requireAuth, async (req, res) => {
   }
 })
 
-router.get("/settings", allowIfNoApiKeys, async (req, res) => {
-  try {
-    const settings = await getSettings()
-    res.json(settings)
-  } catch (err) {
-    handleError(res, err)
-  }
-})
-
-router.put("/settings", allowIfNoApiKeys, async (req, res) => {
-  try {
-    const settings = await updateSettings(req.body || {})
-    res.json({ ok: true, settings })
-  } catch (err) {
-    handleError(res, err)
-  }
-})
-
-// Bootstrapping middleware for settings and api-keys when no API keys exist
-async function allowIfNoApiKeys(req, res, next) {
-  try {
-    const { getCachedSettings } = require("../middleware/auth")
-    const settings = await getCachedSettings()
-    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : []
-    if (apiKeys.length === 0) {
-      return next()
-    }
-    // If API keys exist, require auth
-    return requireAuth(req, res, next)
-  } catch (err) {
-    console.error("Bootstrapping middleware error:", err)
-    // Fail open on error
-    next()
-  }
-}
-
 router.post("/", requireAuth, async (req, res) => {
   try {
     const sourceType = String((req.body && req.body.source_type) || "json").trim().toLowerCase()
@@ -225,37 +189,6 @@ router.post("/upload", requireAuth, async (req, res) => {
   }
 })
 
-// List clients endpoint (must be before /:name)
-router.get("/clients", requireAuth, async (req, res) => {
-  try {
-    const storage = getStorage()
-    const clientKeys = await storage.listKeys("client:")
-    const clients = []
-    
-    for (const key of clientKeys) {
-      try {
-        const client = await storage.get(key)
-        if (client && client.client_id) {
-          clients.push(client)
-        }
-      } catch (err) {
-        // Skip if client read fails
-      }
-    }
-    
-    // Sort by last_seen descending
-    clients.sort((a, b) => new Date(b.last_seen) - new Date(a.last_seen))
-    
-    if (req.query.format !== "json" && req.accepts("html") && !req.xhr && !req.headers["x-requested-with"]) {
-      return res.render("clients", { clients })
-    }
-    
-    res.json({ clients })
-  } catch (err) {
-    handleError(res, err)
-  }
-})
-
 router.get("/:name", requireAuth, async (req, res) => {
   try {
     const plugin = await getServerPlugin(req.params.name)
@@ -409,53 +342,4 @@ router.get("/clients", async (req, res) => {
   }
 })
 
-// API Keys endpoints
-
-// POST /api/plugins/api-keys - Create API key
-router.post("/api-keys", allowIfNoApiKeys, async (req, res) => {
-  try {
-    const { name } = req.body || {}
-    if (!name || typeof name !== "string") {
-      return res.status(400).json({ error: "name is required", type: "invalid_argument" })
-    }
-
-    const settings = await getSettings()
-    const crypto = require("crypto")
-    const key = crypto.randomBytes(32).toString("hex")
-
-    const newApiKey = {
-      name: String(name).trim(),
-      key,
-      created_at: new Date().toISOString()
-    }
-
-    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : []
-    apiKeys.push(newApiKey)
-
-    await updateSettings({ api_keys: apiKeys })
-    res.status(201).json(newApiKey)
-  } catch (err) {
-    handleError(res, err)
-  }
-})
-
-// DELETE /api/plugins/api-keys/:key - Delete API key
-router.delete("/api-keys/:key", allowIfNoApiKeys, async (req, res) => {
-  try {
-    const keyToDelete = req.params.key
-    const settings = await getSettings()
-    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : []
-    const filtered = apiKeys.filter(k => k.key !== keyToDelete)
-
-    if (filtered.length === apiKeys.length) {
-      return res.status(404).json({ error: "API key not found", type: "resource_not_found" })
-    }
-
-    await updateSettings({ api_keys: filtered })
-    res.json({ ok: true })
-  } catch (err) {
-    handleError(res, err)
-  }
-})
-
 module.exports = router

package/server/routes/settings.js

@@ -0,0 +1,93 @@
+const { Router } = require("express");
+const { getSettings, updateSettings } = require("../services/pluginsService");
+
+const router = Router();
+
+// Helper function to handle errors
+function handleError(res, err) {
+  console.error(err);
+  const status = err.status || 500;
+  const error = err.error || { code: 500, type: "internal_error", message: err.message || "Internal server error" };
+  res.status(status).json({ error });
+}
+
+// GET /settings - Render settings view
+router.get("/settings", async (req, res) => {
+  try {
+    const settings = await getSettings()
+    if (req.query.format !== "json" && req.accepts("html") && !req.xhr && !req.headers["x-requested-with"]) {
+      return res.render("settings", { settings })
+    }
+    res.json(settings)
+  } catch (err) {
+    handleError(res, err)
+  }
+})
+
+// PUT /settings - Update settings
+router.put("/settings", async (req, res) => {
+  try {
+    const settings = await updateSettings(req.body || {})
+    res.json({ ok: true, settings })
+  } catch (err) {
+    handleError(res, err)
+  }
+})
+
+// GET /api-keys - Render API keys view
+router.get("/api-keys", async (req, res) => {
+  try {
+    const settings = await getSettings()
+    if (req.query.format !== "json" && req.accepts("html") && !req.xhr && !req.headers["x-requested-with"]) {
+      return res.render("api-keys", { settings })
+    }
+    res.json({ api_keys: settings.api_keys || [] })
+  } catch (err) {
+    handleError(res, err)
+  }
+})
+
+// POST /api-keys - Create API key
+router.post("/api-keys", async (req, res) => {
+  try {
+    const { name } = req.body || {}
+    if (!name || typeof name !== "string") {
+      return res.status(400).json({ error: "name is required", type: "invalid_argument" })
+    }
+
+    const settings = await getSettings()
+    const crypto = require("crypto")
+    const key = crypto.randomBytes(32).toString("hex")
+
+    const newApiKey = {
+      name: String(name).trim(),
+      key,
+      created_at: new Date().toISOString()
+    }
+
+    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : []
+    apiKeys.push(newApiKey)
+
+    await updateSettings({ api_keys: apiKeys })
+    res.status(201).json(newApiKey)
+  } catch (err) {
+    handleError(res, err)
+  }
+})
+
+// DELETE /api-keys/:key - Delete API key
+router.delete("/api-keys/:key", async (req, res) => {
+  try {
+    const keyToDelete = req.params.key
+    const settings = await getSettings()
+    const apiKeys = Array.isArray(settings.api_keys) ? settings.api_keys : []
+    const filtered = apiKeys.filter(k => k.key !== keyToDelete)
+
+    await updateSettings({ api_keys: filtered })
+    res.json({ ok: true })
+  } catch (err) {
+    handleError(res, err)
+  }
+})
+
+module.exports = router;