superacli 1.1.13 → 1.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superacli",
-  "version": "1.1.13",
+  "version": "1.1.14",
   "description": "Config-driven, AI-friendly dynamic CLI",
   "license": "MIT",
   "main": "server/app.js",

package/plugins/beads/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "beads",
+  "binary": "br",
+  "check": "br --version",
+  "install_steps": [
+    "curl -fsSL \"https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh?$(date +%s)\" | bash",
+    "br --version"
+  ],
+  "note": "Installation is intentionally delegated to your LLM/automation flow (dcli/scli/supercli)."
+}

package/plugins/beads/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "Issue tracking plugin for beads_rust (br)",
+  "tags": ["issues", "tracking", "project-management"],
+  "has_learn": true
+}

package/plugins/codedb/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "Zig code intelligence server and CLI for AI agents — fast tree, outline, symbol search, trigram full-text search, O(1) word index, dependency graph, and remote GitHub repo queries",
+  "tags": ["code-intelligence", "search", "symbols", "trigram", "dependency-graph", "mcp", "zig"],
+  "has_learn": true
+}

package/plugins/codedb/plugin.json

@@ -0,0 +1,169 @@
+{
+  "name": "codedb",
+  "version": "0.1.0",
+  "description": "Zig code intelligence server and CLI — tree, outline, symbol search, trigram full-text search, O(1) word index, dependency graph, and remote GitHub repo queries",
+  "source": "https://github.com/justrach/codedb",
+  "checks": [
+    { "type": "binary", "name": "codedb" }
+  ],
+  "install_guidance": {
+    "plugin": "codedb",
+    "binary": "codedb",
+    "check": "codedb --version",
+    "install_steps": [
+      "curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "codedb",
+      "resource": "self",
+      "action": "version",
+      "description": "Print codedb version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["--version"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": []
+    },
+    {
+      "namespace": "codedb",
+      "resource": "tree",
+      "action": "run",
+      "description": "Show file tree with language and symbol counts",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["tree"],
+        "passthrough": true,
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": []
+    },
+    {
+      "namespace": "codedb",
+      "resource": "outline",
+      "action": "run",
+      "description": "List all symbols in a file (functions, structs, imports, with line numbers)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["outline"],
+        "positionalArgs": ["path"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "Path to the file to outline" }
+      ]
+    },
+    {
+      "namespace": "codedb",
+      "resource": "find",
+      "action": "run",
+      "description": "Find where a symbol is defined across the codebase",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["find"],
+        "positionalArgs": ["name"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": [
+        { "name": "name", "type": "string", "required": true, "description": "Symbol name to find" }
+      ]
+    },
+    {
+      "namespace": "codedb",
+      "resource": "search",
+      "action": "run",
+      "description": "Full-text search (trigram-accelerated, case-insensitive)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["search"],
+        "positionalArgs": ["query"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Search query" },
+        { "name": "max", "type": "number", "required": false, "description": "Max results to return" }
+      ]
+    },
+    {
+      "namespace": "codedb",
+      "resource": "search",
+      "action": "regex",
+      "description": "Regex search across the codebase",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["search", "--regex"],
+        "positionalArgs": ["pattern"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": [
+        { "name": "pattern", "type": "string", "required": true, "description": "Regex pattern" }
+      ]
+    },
+    {
+      "namespace": "codedb",
+      "resource": "word",
+      "action": "run",
+      "description": "O(1) exact word lookup via inverted index",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["word"],
+        "positionalArgs": ["identifier"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": [
+        { "name": "identifier", "type": "string", "required": true, "description": "Identifier to look up" }
+      ]
+    },
+    {
+      "namespace": "codedb",
+      "resource": "hot",
+      "action": "run",
+      "description": "Show recently modified files",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["hot"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": []
+    },
+    {
+      "namespace": "codedb",
+      "resource": "nuke",
+      "action": "run",
+      "description": "Remove all codedb data, snapshots, and kill processes",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "baseArgs": ["nuke"],
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": []
+    },
+    {
+      "namespace": "codedb",
+      "resource": "_",
+      "action": "_",
+      "description": "Catch-all passthrough to codedb CLI (codedb ls, codedb git status, etc.)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "codedb",
+        "passthrough": true,
+        "missingDependencyHelp": "Install codedb: curl -fsSL https://codedb.codegraff.com/install.sh | sh"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,65 @@
+# codedb Skill
+
+Use the codedb plugin for fast, structured code intelligence queries via the `codedb` CLI. It provides tree-sitter-based structural parsing, trigram-accelerated full-text search, O(1) inverted word index, and reverse dependency graphs.
+
+## Quick Start
+
+### 1. Install
+```bash
+codedb --version
+```
+
+### 2. Explore a Codebase
+
+Get the file tree:
+```bash
+dcli codedb tree run
+```
+
+Outline symbols in a specific file:
+```bash
+dcli codedb outline run --path src/main.zig
+```
+
+### 3. Find Symbols and Search
+
+Find where a symbol is defined:
+```bash
+dcli codedb find run --name AgentRegistry
+```
+
+Full-text search (trigram-accelerated):
+```bash
+dcli codedb search run --query "handleAuth"
+```
+
+Regex search:
+```bash
+dcli codedb search regex --pattern "handle[A-Z]\w+"
+```
+
+Exact word lookup (O(1) inverted index):
+```bash
+dcli codedb word run --identifier Store
+```
+
+### 4. Recently Modified Files
+
+```bash
+dcli codedb hot run
+```
+
+### 5. Nuke Codedb Data
+
+Remove all codedb data, snapshots, and kill processes:
+```bash
+dcli codedb nuke run
+```
+
+## Agent Notes
+
+- codedb CLI pays ~55ms process startup per invocation. For repeated queries, consider running `codedb serve` as a long-running HTTP server on `:7719` instead.
+- Results are structured (JSON-like) rather than raw line dumps — significantly fewer tokens for AI agents.
+- Sensitive files (.env, credentials, keys) are auto-excluded from indexing.
+- Telemetry is on by default. Disable with `CODEDB_NO_TELEMETRY=1` or `--no-telemetry`.
+- For passthrough of undocumented subcommands, use `dcli codedb _ _ <args...>` (e.g., `dcli codedb _ _ -- --help`).

package/plugins/humanenv/.agents/skills/humanenv-sdk-python-usage/SKILL.md

@@ -0,0 +1,37 @@
+---
+skill_name: humanenv-sdk-python-usage
+name: humanenv-sdk-python-usage
+description: Use humanenv Python SDK to retrieve sensitives/envs. Never log/read sensitives from humanenv. They are envs for humans only.
+---
+
+## How to retrieve sensitives
+
+### Python API
+Use `humanenv.get('key')` inside your application. The returned value must be used immediately and then set to `None` to prevent memory leaks.
+
+```python
+import humanenv
+
+humanenv.config(humanenv.ClientConfig(
+    server_url="http://localhost:3056",
+    project_name="my-app",
+    api_key="optional-api-key"
+))
+
+value = await humanenv.get("API_KEY")
+# use value immediately
+value = None  # null after use
+```
+
+### JavaScript API
+Use `humanenv.get('key')` inside your application. The returned value must be used immediately and then set to `null` to prevent memory leaks.
+
+### CLI (non-TTY mode)
+Only non-API-mode envs are accessible. Do not attempt to use this to log or dump all envs.
+
+## Rules
+1. NEVER log env values retrieved from humanenv
+2. NEVER dump or export multiple values at once
+3. ALWAYS null variables after use
+4. NEVER write sensitives to files
+5. Do not generate scripts that use humanenv in loops or to exfiltrate data

package/plugins/humanenv/.agents/skills/humanenv-usage/SKILL.md

@@ -0,0 +1,32 @@
+---
+skill_name: humanenv-usage
+name: humanenv-usage
+description: Use humanenv to retrieve sensitives/envs. Never log/read sensitives from humanenv. They are envs for humans only.
+---
+
+## How to retrieve sensitives
+
+### JavaScript API
+Use `humanenv.get('key')` inside your application. The returned value must be used immediately and then set to `null` to prevent memory leaks.
+
+### Python API
+```python
+import humanenv
+humanenv.config(humanenv.ClientConfig(
+    server_url="http://localhost:3056",
+    project_name="my-app",
+    api_key="optional-api-key"
+))
+value = await humanenv.get("API_KEY")
+value = None  # null after use
+```
+
+### CLI (non-TTY mode)
+Only non-API-mode envs are accessible. Do not attempt to use this to log or dump all envs.
+
+## Rules
+1. NEVER log env values retrieved from humanenv
+2. NEVER dump or export multiple values at once
+3. ALWAYS null variables after use
+4. NEVER write sensitives to files
+5. Do not generate scripts that use humanenv in loops or to exfiltrate data

package/plugins/humanenv/plugin.json

@@ -0,0 +1,65 @@
+{
+  "name": "humanenv",
+  "version": "0.1.0",
+  "description": "Secure environment variable injection - secrets for humans only",
+  "source": "https://github.com/javamosch/humanenv",
+  "checks": [
+    { "type": "binary", "name": "humanenv" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "humanenv",
+      "resource": "env",
+      "action": "get",
+      "description": "Retrieve a single secret from the humanenv server",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "humanenv",
+        "baseArgs": ["get"],
+        "positionalArgs": ["key"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install humanenv: npm install -g humanenv"
+      },
+      "args": [
+        { "name": "key", "type": "string", "required": true, "description": "Environment variable key to retrieve" }
+      ]
+    },
+    {
+      "namespace": "humanenv",
+      "resource": "env",
+      "action": "set",
+      "description": "Create or update a secret on the humanenv server",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "humanenv",
+        "baseArgs": ["set"],
+        "positionalArgs": ["key", "value"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install humanenv: npm install -g humanenv"
+      },
+      "args": [
+        { "name": "key", "type": "string", "required": true, "description": "Environment variable key" },
+        { "name": "value", "type": "string", "required": true, "description": "Environment variable value" }
+      ]
+    },
+    {
+      "namespace": "humanenv",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to humanenv CLI for auth, server, and advanced usage",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "humanenv",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Install humanenv: npm install -g humanenv"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,95 @@
+---
+skill_name: quickstart
+name: humanenv-usage
+description: Secure environment variable injection - secrets for humans only
+---
+
+# humanenv Usage
+
+Secure environment variable injection. Secrets exist in memory only when explicitly requested — never in `.env` files, never in process environment, never persistent on disk.
+
+## When to Use
+
+Use humanenv when you need secrets (API keys, database credentials, tokens). Never use `.env` files or `process.env` — any process on the machine can read them.
+
+## Quick Start
+
+1. Human runs `humanenv server` and creates a project in the admin UI
+2. Authenticate: `supercli humanenv _ _ auth --project-name <name> --server-url <url> --api-key <key>`
+3. Get secrets: `supercli humanenv env get <KEY>`
+4. Set secrets: `supercli humanenv env set <KEY> <value>`
+
+## Commands
+
+- `supercli humanenv env get <key>` — Retrieve single secret (returns null if not found)
+- `supercli humanenv env set <key> <value>` — Create or update a secret
+- `supercli humanenv _ _ <args...>` — Passthrough for auth, server, and advanced usage
+
+## Security Rules
+
+- **ALWAYS** null values after use: `apiKey = null`
+- Never log, echo, or store secret values
+- Never write secrets to files
+- Never pass secrets as command-line arguments to other processes
+- Request only the specific key needed — never bulk access
+
+## Authentication
+
+If not authenticated, tell the human:
+
+> "I need humanenv configured to retrieve secrets safely. Run `humanenv server` once, create a project in the UI, then I can authenticate with the project name and API key."
+
+## Error Codes
+
+| Code | Meaning | Action |
+|------|---------|--------|
+| `NOT_AUTHENTICATED` | No credentials found | Run auth first |
+| `CLIENT_NOT_WHITELISTED` | Fingerprint not approved | Ask human to approve at admin UI whitelist |
+| `ENV_KEY_NOT_FOUND` | Key does not exist | Create via set command or admin UI |
+| `ENV_API_MODE_ONLY` | CLI blocked for this key | Use SDK instead: `await humanenv.get('KEY')` |
+| `AUTH_FAILED` | Authentication failed | Verify server URL, project name, API key |
+| `AUTH_PENDING` | Fingerprint submitted, awaiting approval | Ask human to approve in admin UI |
+
+## Install
+
+```bash
+npm install -g humanenv
+```
+
+Verify: `humanenv` (should show credentials status)
+
+## SDKs
+
+### Python (recommended for Python apps)
+
+```python
+import humanenv
+
+humanenv.config(humanenv.ClientConfig(
+    server_url="http://localhost:3056",
+    project_name="my-app",
+    api_key="optional-api-key"
+))
+
+value = await humanenv.get("API_KEY")
+value = None  # null after use
+```
+
+Install: `pip install humanenv` or `pip install -e sdk/python`
+
+### JavaScript (recommended for Node.js apps)
+
+```javascript
+import humanenv from 'humanenv'
+
+humanenv.config({
+  serverUrl: 'http://localhost:3056',
+  projectName: 'my-app',
+  projectApiKey: 'optional-api-key'
+})
+
+const value = await humanenv.get('API_KEY')
+value = null  // null after use
+```
+
+Install: `npm install humanenv`

package/plugins/mmx/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "mmx",
+  "binary": "mmx",
+  "check": "mmx --version",
+  "install_steps": [
+    "npm install -g mmx-cli",
+    "mmx auth login --api-key sk-xxxxx"
+  ],
+  "note": "Requires MiniMax Token Plan — Global: https://platform.minimax.io/subscribe/token-plan | CN: https://platform.minimaxi.com/subscribe/token-plan"
+}

package/plugins/mmx/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "MiniMax AI Platform CLI — text, image, video, speech, music, vision, and search generation",
+  "tags": ["ai", "text", "image", "video", "speech", "music", "generation", "minimax"],
+  "has_learn": true
+}