superacli 1.1.26 → 1.1.28

package/plugins/kustomize/plugin.json

@@ -0,0 +1,108 @@
+{
+  "name": "kustomize",
+  "version": "0.1.0",
+  "description": "kustomize — Kubernetes configuration customization tool with template-free YAML management",
+  "source": "https://github.com/kubernetes-sigs/kustomize",
+  "checks": [
+    { "type": "binary", "name": "kustomize" }
+  ],
+  "install_guidance": {
+    "plugin": "kustomize",
+    "binary": "kustomize",
+    "check": "which kustomize",
+    "install_steps": [
+      "brew install kustomize",
+      "Verify: kustomize version",
+      "supercli plugins install ./plugins/kustomize --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "kustomize",
+      "resource": "self",
+      "action": "version",
+      "description": "Print kustomize version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "kustomize",
+        "baseArgs": ["version"],
+        "missingDependencyHelp": "Install kustomize: brew install kustomize"
+      },
+      "args": []
+    },
+    {
+      "namespace": "kustomize",
+      "resource": "build",
+      "action": "run",
+      "description": "Build kustomization to produce Kubernetes resources",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "kustomize",
+        "baseArgs": ["build"],
+        "positionalArgs": ["dir"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install kustomize"
+      },
+      "args": [
+        { "name": "dir", "type": "string", "required": false, "description": "Directory containing kustomization.yaml" }
+      ]
+    },
+    {
+      "namespace": "kustomize",
+      "resource": "build",
+      "action": "output",
+      "description": "Build and write output to file",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "kustomize",
+        "baseArgs": ["build"],
+        "positionalArgs": ["dir"],
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install kustomize"
+      },
+      "args": [
+        { "name": "dir", "type": "string", "required": false, "description": "Directory containing kustomization.yaml" },
+        { "name": "output", "type": "string", "required": false, "description": "Output file path (-o)" }
+      ]
+    },
+    {
+      "namespace": "kustomize",
+      "resource": "edit",
+      "action": "add-resource",
+      "description": "Add a resource to kustomization.yaml",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "kustomize",
+        "baseArgs": ["edit", "add", "resource"],
+        "positionalArgs": ["resource"],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install kustomize"
+      },
+      "args": [
+        { "name": "resource", "type": "string", "required": true, "description": "Resource file path" }
+      ]
+    },
+    {
+      "namespace": "kustomize",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to kustomize CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "kustomize",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "missingDependencyHelp": "Install kustomize"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+---
+name: kustomize
+description: Use this skill when the user wants to customize Kubernetes configurations, manage K8s YAML with overlays, patch resources, or build kustomizations for different environments.
+---
+
+# kustomize Plugin
+
+Kubernetes configuration customization tool.
+
+## Commands
+
+### Build
+- `kustomize build run` — Build kustomization to produce Kubernetes resources
+- `kustomize build output` — Build and write output to file
+
+### Edit
+- `kustomize edit add-resource` — Add a resource to kustomization.yaml
+
+## Usage Examples
+- "Build Kubernetes resources from kustomization"
+- "Add a resource to kustomization.yaml"
+- "Generate K8s YAML for production overlay"
+
+## Installation
+
+```bash
+brew install kustomize
+```
+
+## Examples
+
+```bash
+# Build kustomization
+kustomize build .
+
+# Build with overlay
+kustomize build overlays/production
+
+# Output to file
+kustomize build . -o output.yaml
+
+# Add resource
+kustomize edit add resource deployment.yaml
+
+# Add label transformer
+kustomize edit add label app:myapp
+```

package/plugins/lalrpop/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"lalrpop","binary":"lalrpop","check":"which lalrpop","install_steps":["brew install lalrpop","Verify: lalrpop --version","supercli plugins install ./plugins/lalrpop --on-conflict replace --json"]}

package/plugins/lalrpop/meta.json

@@ -0,0 +1 @@
+{"description":"lalrpop","tags":["lalrpop"],"has_learn":true}

package/plugins/lalrpop/plugin.json

@@ -0,0 +1 @@
+{"name":"TOOL","version":"0.1.0","description":"Tool","source":"https://github.com","checks":[{"type":"binary","name":"TOOL"}],"install_guidance":{"plugin":"TOOL","binary":"TOOL","check":"which TOOL","install_steps":["brew install TOOL","Verify: TOOL --version","supercli plugins install ./plugins/TOOL --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"TOOL","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"TOOL","baseArgs":["--version"],"missingDependencyHelp":"Install TOOL"},"args":[]}]}

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

@@ -0,0 +1 @@
+# lalrpop

package/plugins/lame/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"lame","binary":"lame","check":"which lame","install_steps":["brew install lame","Verify: lame --version","supercli plugins install ./plugins/lame --on-conflict replace --json"]}

package/plugins/lame/meta.json

@@ -0,0 +1 @@
+{"description":"LAME is a high-quality MPEG-1 Layer III (MP3) encoder. Creates high-fidelity MP3 files from various audio formats with excellent compression ratios.","tags":["lame","mp3","audio","encoder","codec"],"has_learn":true}

package/plugins/lame/plugin.json

@@ -0,0 +1 @@
+{"name":"lame","version":"0.1.0","description":"lame — high-quality MPEG-1 Layer III (MP3) encoder","source":"https://github.com/rbrito/lame","checks":[{"type":"binary","name":"lame"}],"install_guidance":{"plugin":"lame","binary":"lame","check":"which lame","install_steps":["brew install lame","Verify: lame --version","supercli plugins install ./plugins/lame --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"lame","resource":"self","action":"version","description":"Print lame version","adapter":"process","adapterConfig":{"command":"lame","baseArgs":["--version"],"missingDependencyHelp":"Install: brew install lame"},"args":[]},{"namespace":"lame","resource":"encode","action":"mp3","description":"Encode audio to MP3","adapter":"process","adapterConfig":{"command":"lame","positionalArgs":["input","output"],"cwd":"invoke_cwd","passthrough":true,"timeout_ms":300000,"missingDependencyHelp":"Install lame"},"args":[{"name":"input","type":"string","required":true,"description":"Input audio file"},{"name":"output","type":"string","required":true,"description":"Output MP3 file"}]},{"namespace":"lame","resource":"_","action":"_","description":"Passthrough to lame CLI","adapter":"process","adapterConfig":{"command":"lame","cwd":"invoke_cwd","passthrough":true,"missingDependencyHelp":"Install lame"},"args":[]}]}

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

@@ -0,0 +1,13 @@
+# Quickstart
+
+See GitHub repository for comprehensive documentation and usage examples.
+
+## Installation
+
+See install-guidance.json for detailed installation instructions.
+
+## Resources
+
+- GitHub repository in plugin source
+- Official website
+- Documentation and examples

package/plugins/lazydocker/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"lazydocker","binary":"lazydocker","check":"which lazydocker","install_steps":["brew install lazydocker","Verify: lazydocker --version","supercli plugins install ./plugins/lazydocker --on-conflict replace --json"]}

package/plugins/lazydocker/meta.json

@@ -1,5 +1 @@
-{
-  "description": "A terminal UI for both docker and docker-compose. Manage containers, images, volumes, and networks with an intuitive terminal interface. View logs, attach to containers, and manage services without leaving the terminal.",
-  "tags": ["docker", "terminal", "ui", "containers", "devops"],
-  "has_learn": true
-}
+{"description":"lazydocker provides a simple TUI for docker commands. Streamlines container management, logs viewing, and image operations.","tags":["lazydocker","docker","tui","containers"],"has_learn":true}

package/plugins/lazydocker/plugin.json

@@ -1,84 +1 @@
-{
-  "name": "lazydocker",
-  "version": "0.1.0",
-  "description": "A terminal UI for both docker and docker-compose",
-  "source": "https://github.com/jesseduffield/lazydocker",
-  "checks": [
-    { "type": "binary", "name": "lazydocker" }
-  ],
-  "install_guidance": {
-    "plugin": "lazydocker",
-    "binary": "lazydocker",
-    "check": "which lazydocker",
-    "install_steps": [
-      "curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash",
-      "Or: brew install lazydocker",
-      "supercli plugins install ./plugins/lazydocker --on-conflict replace --json"
-    ]
-  },
-  "learn": {
-    "file": "skills/quickstart/SKILL.md"
-  },
-  "commands": [
-    {
-      "namespace": "lazydocker",
-      "resource": "self",
-      "action": "version",
-      "description": "Print lazydocker version",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazydocker",
-        "baseArgs": ["--version"],
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazydocker: curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": []
-    },
-    {
-      "namespace": "lazydocker",
-      "resource": "ui",
-      "action": "open",
-      "description": "Open lazydocker terminal UI",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazydocker",
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazydocker: curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": [
-        { "name": "--config-file", "type": "string", "required": false, "description": "Path to config file" },
-        { "name": "--cwd", "type": "string", "required": false, "description": "Working directory to use" }
-      ]
-    },
-    {
-      "namespace": "lazydocker",
-      "resource": "logs",
-      "action": "view",
-      "description": "View logs for a container",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazydocker",
-        "baseArgs": ["--logs"],
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazydocker: curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": [
-        { "name": "container", "type": "string", "required": false, "description": "Container name or ID" }
-      ]
-    },
-    {
-      "namespace": "lazydocker",
-      "resource": "_",
-      "action": "_",
-      "description": "Passthrough to lazydocker CLI",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazydocker",
-        "cwd": "invoke_cwd",
-        "passthrough": true,
-        "missingDependencyHelp": "Install lazydocker: curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": []
-    }
-  ]
-}
+{"name":"lazydocker","version":"0.1.0","description":"lazydocker — simple docker command wrapper (TUI)","source":"https://github.com/jesseduffield/lazydocker","checks":[{"type":"binary","name":"lazydocker"}],"install_guidance":{"plugin":"lazydocker","binary":"lazydocker","check":"which lazydocker","install_steps":["brew install lazydocker","Verify: lazydocker --version","supercli plugins install ./plugins/lazydocker --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"lazydocker","resource":"self","action":"version","description":"Print lazydocker version","adapter":"process","adapterConfig":{"command":"lazydocker","baseArgs":["--version"],"missingDependencyHelp":"Install: brew install lazydocker"},"args":[]},{"namespace":"lazydocker","resource":"ui","action":"open","description":"Open lazydocker UI","adapter":"process","adapterConfig":{"command":"lazydocker","passthrough":true,"timeout_ms":600000,"missingDependencyHelp":"Install lazydocker"},"args":[]}]}

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

@@ -1,74 +1,11 @@
-# lazydocker Plugin
+# Quickstart
 
-## Overview
-The lazydocker plugin provides a terminal UI for both docker and docker-compose. Manage containers, images, volumes, and networks with an intuitive terminal interface.
+Comprehensive documentation available in the repository.
 
-## What is lazydocker?
-`lazydocker` is a terminal UI for docker and docker-compose. It provides a visual interface to manage all your docker resources without leaving the terminal.
+## Installation
 
-## Quick Start
-
-### 1. Install lazydocker
-```bash
-curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash
-# or with Homebrew
-brew install lazydocker
-```
-
-### 2. Open the UI
-```bash
-sc lazydocker ui open
-```
-
-### 3. Verify installation
-```bash
-sc lazydocker self version
-```
-
-## Features
-- **Container Management**: Start, stop, restart, remove containers
-- **Logs**: View container logs with filtering
-- **Stats**: Monitor container resource usage
-- **Image Management**: View, remove, and prune images
-- **Volume Management**: Manage docker volumes
-- **Network Management**: View and manage networks
-- **Docker Compose**: Manage compose projects
-
-## Keybindings (in UI)
-- `q` or `Ctrl+C`: Quit
-- `x`: Remove selected item
-- `e`: Remove selected item with confirmation
-- `s`: Stop container
-- `r`: Restart container
-- `l`: View logs
-- `enter`: View details
-- `]` and `[`: Navigate panels
-
-## Useful Commands
-- `sc lazydocker ui open` - Open the lazydocker terminal UI
-- `sc lazydocker logs view [container]` - View logs for a container
-- `sc lazydocker ui open --cwd /path/to/project` - Open in specific directory
-
-## Requirements
-- Docker installed and running
-- Docker Compose (optional, for compose projects)
-
-## Configuration
-Create `~/.config/lazydocker/config.yml` to customize behavior:
-```yaml
-gui:
-  theme:
-    activeBorderColor:
-      - green
-      - bold
-```
-
-## Tips
-- Use arrow keys or vim-style navigation (j/k)
-- Press `?` in the UI for help
-- Use `/` to search/filter lists
-- Press `space` to select multiple items
+See install-guidance.json for setup instructions.
 
 ## Resources
-- GitHub: https://github.com/jesseduffield/lazydocker
-- Documentation: https://github.com/jesseduffield/lazydocker
+
+- GitHub repository link in plugin source

package/plugins/lazygit/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"lazygit","binary":"lazygit","check":"which lazygit","install_steps":["brew install lazygit","Verify: lazygit --version","supercli plugins install ./plugins/lazygit --on-conflict replace --json"]}

package/plugins/lazygit/meta.json

@@ -1,5 +1 @@
-{
-  "description": "A terminal UI for git commands. Interact with git repositories through a visual interface. Stage files, commit, push, pull, manage branches, and resolve conflicts without leaving the terminal.",
-  "tags": ["git", "terminal", "ui", "vcs", "version-control"],
-  "has_learn": true
-}
+{"description":"lazygit provides a simple TUI for git commands. Streamlines common git operations like staging, committing, and branch management.","tags":["lazygit","git","tui"],"has_learn":true}

package/plugins/lazygit/plugin.json

@@ -1,85 +1 @@
-{
-  "name": "lazygit",
-  "version": "0.1.0",
-  "description": "A terminal UI for git commands",
-  "source": "https://github.com/jesseduffield/lazygit",
-  "checks": [
-    { "type": "binary", "name": "lazygit" }
-  ],
-  "install_guidance": {
-    "plugin": "lazygit",
-    "binary": "lazygit",
-    "check": "which lazygit",
-    "install_steps": [
-      "curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash",
-      "Or: brew install lazygit",
-      "supercli plugins install ./plugins/lazygit --on-conflict replace --json"
-    ]
-  },
-  "learn": {
-    "file": "skills/quickstart/SKILL.md"
-  },
-  "commands": [
-    {
-      "namespace": "lazygit",
-      "resource": "self",
-      "action": "version",
-      "description": "Print lazygit version",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazygit",
-        "baseArgs": ["--version"],
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazygit: curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": []
-    },
-    {
-      "namespace": "lazygit",
-      "resource": "ui",
-      "action": "open",
-      "description": "Open lazygit terminal UI",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazygit",
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazygit: curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": [
-        { "name": "--path", "type": "string", "required": false, "description": "Path to git repository" },
-        { "name": "--filter", "type": "string", "required": false, "description": "Path filter for files" },
-        { "name": "--worktree", "type": "string", "required": false, "description": "Path to worktree" }
-      ]
-    },
-    {
-      "namespace": "lazygit",
-      "resource": "log",
-      "action": "view",
-      "description": "View git log in lazygit",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazygit",
-        "baseArgs": ["log"],
-        "cwd": "invoke_cwd",
-        "missingDependencyHelp": "Install lazygit: curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": [
-        { "name": "--path", "type": "string", "required": false, "description": "Path to git repository" }
-      ]
-    },
-    {
-      "namespace": "lazygit",
-      "resource": "_",
-      "action": "_",
-      "description": "Passthrough to lazygit CLI",
-      "adapter": "process",
-      "adapterConfig": {
-        "command": "lazygit",
-        "cwd": "invoke_cwd",
-        "passthrough": true,
-        "missingDependencyHelp": "Install lazygit: curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash"
-      },
-      "args": []
-    }
-  ]
-}
+{"name":"lazygit","version":"0.1.0","description":"lazygit — simple git command wrapper (TUI)","source":"https://github.com/jesseduffield/lazygit","checks":[{"type":"binary","name":"lazygit"}],"install_guidance":{"plugin":"lazygit","binary":"lazygit","check":"which lazygit","install_steps":["brew install lazygit","Verify: lazygit --version","supercli plugins install ./plugins/lazygit --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"lazygit","resource":"self","action":"version","description":"Print lazygit version","adapter":"process","adapterConfig":{"command":"lazygit","baseArgs":["--version"],"missingDependencyHelp":"Install: brew install lazygit"},"args":[]},{"namespace":"lazygit","resource":"ui","action":"open","description":"Open lazygit UI","adapter":"process","adapterConfig":{"command":"lazygit","cwd":"invoke_cwd","passthrough":true,"timeout_ms":600000,"missingDependencyHelp":"Install lazygit"},"args":[]}]}

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

@@ -1,79 +1,11 @@
-# lazygit Plugin
+# Quickstart
 
-## Overview
-The lazygit plugin provides a terminal UI for git commands. Interact with git repositories through a visual interface without leaving the terminal.
+Comprehensive documentation available in the repository.
 
-## What is lazygit?
-`lazygit` is a terminal UI for git operations. It provides an intuitive interface for staging files, committing, pushing, pulling, managing branches, and resolving conflicts.
+## Installation
 
-## Quick Start
-
-### 1. Install lazygit
-```bash
-curl https://raw.githubusercontent.com/jesseduffield/lazygit/master/scripts/install_update_linux.sh | bash
-# or with Homebrew
-brew install lazygit
-```
-
-### 2. Open the UI
-```bash
-sc lazygit ui open
-```
-
-### 3. Verify installation
-```bash
-sc lazygit self version
-```
-
-## Features
-- **File Staging**: Stage/unstage files with visual feedback
-- **Commit**: Create commits with message editor
-- **Branch Management**: Create, checkout, delete branches
-- **Merge/Rebase**: Handle merges and rebases visually
-- **Stashing**: Stash and pop changes
-- **Log View**: View commit history with diff
-- **Conflict Resolution**: Resolve merge conflicts
-- **Push/Pull**: Sync with remote repositories
-
-## Keybindings (in UI)
-- `q`: Quit
-- `x`: Remove selected item
-- `space`: Stage/unstage file
-- `c`: Commit
-- `P`: Push
-- `p`: Pull
-- `b`: Checkout branch
-- `F`: Fetch
-- `enter`: View details
-- `]` and `[`: Navigate panels
-
-## Useful Commands
-- `sc lazygit ui open` - Open lazygit in current directory
-- `sc lazygit ui open --path /path/to/repo` - Open in specific repository
-- `sc lazygit log view` - View git log in lazygit
-- `sc lazygit ui open --filter "*.js"` - Filter files by pattern
-
-## Requirements
-- Git installed
-- Git repository (lazygit auto-detects)
-
-## Configuration
-Create `~/.config/lazygit/config.yml` to customize:
-```yaml
-gui:
-  theme:
-    activeBorderColor:
-      - green
-      - bold
-```
-
-## Tips
-- Use arrow keys or vim-style navigation (j/k)
-- Press `?` in the UI for help
-- Use `/` to search/filter lists
-- Press `space` to stage/unstage files
-- Use `c` then `c` to commit with message
+See install-guidance.json for setup instructions.
 
 ## Resources
-- GitHub: https://github.com/jesseduffield/lazygit
-- Documentation: https://github.com/jesseduffield/lazygit
+
+- GitHub repository link in plugin source

package/plugins/libp2p/install-guidance.json

@@ -0,0 +1 @@
+{"plugin":"libp2p","binary":"libp2p","check":"which libp2p","install_steps":["cargo install libp2p","Verify: libp2p --version","supercli plugins install ./plugins/libp2p --on-conflict replace --json"]}

package/plugins/libp2p/meta.json

@@ -0,0 +1 @@
+{"description":"libp2p","tags":["libp2p"],"has_learn":true}

package/plugins/libp2p/plugin.json

@@ -0,0 +1 @@
+{"name":"libp2p","version":"0.1.0","description":"libp2p","source":"https://github.com","checks":[{"type":"binary","name":"libp2p"}],"install_guidance":{"plugin":"libp2p","binary":"libp2p","check":"which libp2p","install_steps":["cargo install libp2p","Verify: libp2p --version","supercli plugins install ./plugins/libp2p --on-conflict replace --json"]},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"libp2p","resource":"self","action":"version","description":"Version","adapter":"process","adapterConfig":{"command":"libp2p","baseArgs":["--version"],"missingDependencyHelp":"Install libp2p"},"args":[]}]}

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

@@ -0,0 +1 @@
+# libp2p

package/plugins/lightpanda/install-guidance.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "lightpanda",
+  "binary": "lightpanda",
+  "check": "which lightpanda",
+  "install_steps": [
+    "brew install lightpanda",
+    "Verify: lightpanda --version",
+    "supercli plugins install ./plugins/lightpanda --on-conflict replace --json"
+  ]
+}

package/plugins/lightpanda/meta.json

@@ -0,0 +1,7 @@
+{
+  "description": "Lightpanda plugin with agent-friendly scripted browser automation via puppeteer-core",
+  "tags": [
+    "lightpanda"
+  ],
+  "has_learn": true
+}

package/plugins/lightpanda/skills/generic-extraction.md

@@ -64,3 +64,25 @@ return {
 - `console.log(...)` goes to stderr.
 - Prefer returning small, structured objects.
 - If `context.navigation` is `null`, your run started without `--url`.
+
+## Caveats
+
+### SPA / Client-Side Rendered Pages
+
+`extract run` navigates with the browser and then exposes `$` / `html` from `page.content()`. For SPAs (Vue, React, Angular), `page.content()` reflects the pre-render HTML shell — the `$` instance operates on an empty app container, not the rendered component tree.
+
+Prefer using the injected `fetch` to retrieve raw HTML from an endpoint and parsing it with cheerio manually when the target is a SPA:
+```js
+const resp = await fetch('http://localhost:8080/');
+const html = await resp.text();
+const $ = cheerio.load(html);
+return { title: $('title').text(), hasApp: !!$('#app').length };
+```
+
+### resilientGoto Falls Back Silently
+
+When `resilientGoto` falls back to HTTP, `pageData.mode` is `http_fallback` and `pageData.$` is populated from the raw HTTP response. Always check `pageData.mode` before using `pageData.$` to understand which path ran.
+
+### Hash Fragment Navigation
+
+Do not pass hash URLs (`#/route`) to `resilientGoto`. The `#` fragment is sent to Lightpanda as a literal path component and may be percent-encoded or ignored. Target hash-routed pages by fetching the base URL instead.