Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions plugins/argc/install-guidance.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"plugin": "argc",
"binary": "argc",
"check": "which argc",
"install_steps": [
"cargo install argc",
"brew install argc",
"Verify: argc --version",
"supercli plugins install ./plugins/argc --on-conflict replace --json"
],
"note": "Source: https://github.com/sigoden/argc (1143 stars). Written in Rust."
}
5 changes: 5 additions & 0 deletions plugins/argc/meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"description": "argc — Bash CLI framework and command runner",
"tags": ["argc", "bash", "shell", "cli", "rust", "development", "task-runner"],
"has_learn": true
}
103 changes: 103 additions & 0 deletions plugins/argc/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
{
"name": "argc",
"version": "0.1.0",
"description": "argc — Bash CLI framework and command runner",
"source": "https://github.com/sigoden/argc",
"checks": [
{
"type": "binary",
"name": "argc"
}
],
"install_guidance": {
"plugin": "argc",
"binary": "argc",
"check": "which argc",
"install_steps": [
"cargo install argc",
"brew install argc",
"Verify: argc --version",
"supercli plugins install ./plugins/argc --on-conflict replace --json"
]
},
"learn": {
"file": "skills/quickstart/SKILL.md"
},
"commands": [
{
"namespace": "argc",
"resource": "self",
"action": "version",
"description": "Print argc version",
"adapter": "process",
"adapterConfig": {
"command": "argc",
"baseArgs": ["--version"],
"missingDependencyHelp": "Install argc: cargo install argc"
},
"args": []
},
{
"namespace": "argc",
"resource": "script",
"action": "run",
"description": "Run a bash script with argc annotations",
"adapter": "process",
"adapterConfig": {
"command": "argc",
"passthrough": true,
"missingDependencyHelp": "Install argc: cargo install argc",
"cwd": "invoke_cwd"
},
"args": []
},
{
"namespace": "argc",
"resource": "completions",
"action": "generate",
"description": "Generate shell completions for argc",
"adapter": "process",
"adapterConfig": {
"command": "argc",
"baseArgs": ["--completions"],
"passthrough": true,
"missingDependencyHelp": "Install argc: cargo install argc"
},
"args": [
{
"name": "shell",
"type": "string",
"required": false,
"description": "Shell type (bash, zsh, fish, powershell, elvish)"
}
]
},
{
"namespace": "argc",
"resource": "help",
"action": "show",
"description": "Show argc help",
"adapter": "process",
"adapterConfig": {
"command": "argc",
"baseArgs": ["--help"],
"missingDependencyHelp": "Install argc: cargo install argc"
},
"args": []
},
{
"namespace": "argc",
"resource": "_",
"action": "_",
"description": "Passthrough to argc",
"adapter": "process",
"adapterConfig": {
"command": "argc",
"passthrough": true,
"missingDependencyHelp": "Install argc: cargo install argc",
"cwd": "invoke_cwd"
},
"args": []
}
]
}
36 changes: 36 additions & 0 deletions plugins/argc/skills/quickstart/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
name: argc
description: Use this skill when the user wants to create or run Bash CLIs with argc annotations.
---

# argc Plugin

argc is a Bash CLI framework that turns bash scripts into full-featured command-line tools with help messages, argument validation, and shell completions.

## Commands

### Basic
- `argc self version` — Print argc version
- `argc help show` — Show argc help

### Script Execution
- `argc script run` — Run a bash script with argc annotations

### Shell Integration
- `argc completions generate` — Generate shell completions (bash/zsh/fish/powershell/elvish)

### Passthrough
- `argc _ _` — Pass raw arguments to argc binary

## Usage Examples

```bash
# Show argc help
sc argc help show --json

# Run a script with argc annotations
sc argc script run myscript.sh -- --help

# Generate bash completions
sc argc completions generate bash
```
12 changes: 12 additions & 0 deletions plugins/sccache/install-guidance.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"plugin": "sccache",
"binary": "sccache",
"check": "which sccache",
"install_steps": [
"cargo install sccache",
"brew install sccache",
"Verify: sccache --version",
"supercli plugins install ./plugins/sccache --on-conflict replace --json"
],
"note": "Source: https://github.com/mozilla/sccache (7323 stars). Written in Rust."
}
5 changes: 5 additions & 0 deletions plugins/sccache/meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"description": "sccache — shared compiler cache with cloud storage support",
"tags": ["sccache", "rust", "build", "cache", "compiler", "development"],
"has_learn": true
}
108 changes: 108 additions & 0 deletions plugins/sccache/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
{
"name": "sccache",
"version": "0.1.0",
"description": "sccache — shared compiler cache with cloud storage support",
"source": "https://github.com/mozilla/sccache",
"checks": [
{
"type": "binary",
"name": "sccache"
}
],
"install_guidance": {
"plugin": "sccache",
"binary": "sccache",
"check": "which sccache",
"install_steps": [
"cargo install sccache",
"brew install sccache",
"Verify: sccache --version",
"supercli plugins install ./plugins/sccache --on-conflict replace --json"
],
"note": "Source: https://github.com/mozilla/sccache (7323 stars). Written in Rust."
},
"learn": {
"file": "skills/quickstart/SKILL.md"
},
"commands": [
{
"namespace": "sccache",
"resource": "self",
"action": "version",
"description": "Print sccache version",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"baseArgs": ["--version"],
"missingDependencyHelp": "Install sccache: cargo install sccache"
},
"args": []
},
{
"namespace": "sccache",
"resource": "stats",
"action": "show",
"description": "Show sccache cache statistics",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"baseArgs": ["--show-stats"],
"missingDependencyHelp": "Install sccache: cargo install sccache"
},
"args": []
},
{
"namespace": "sccache",
"resource": "cache",
"action": "clear",
"description": "Clear sccache cache",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"baseArgs": ["--clear"],
"missingDependencyHelp": "Install sccache: cargo install sccache"
},
"args": []
},
{
"namespace": "sccache",
"resource": "server",
"action": "start",
"description": "Start sccache server",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"baseArgs": ["--start-server"],
"missingDependencyHelp": "Install sccache: cargo install sccache"
},
"args": []
},
{
"namespace": "sccache",
"resource": "server",
"action": "stop",
"description": "Stop sccache server",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"baseArgs": ["--stop-server"],
"missingDependencyHelp": "Install sccache: cargo install sccache"
},
"args": []
},
{
"namespace": "sccache",
"resource": "_",
"action": "_",
"description": "Passthrough to sccache",
"adapter": "process",
"adapterConfig": {
"command": "sccache",
"passthrough": true,
"missingDependencyHelp": "Install sccache: cargo install sccache",
"cwd": "invoke_cwd"
},
"args": []
}
]
}
39 changes: 39 additions & 0 deletions plugins/sccache/skills/quickstart/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
name: sccache
description: Use this skill when the user wants to manage a shared compiler cache with cloud storage support.
---

# sccache Plugin

sccache is a compiler caching tool (like ccache) with support for local and cloud storage backends (S3, GCS, Azure, Redis).

## Commands

### Version Info
- `sccache self version` — Print sccache version

### Cache Management
- `sccache stats show` — Show cache statistics (hits, misses, size)
- `sccache cache clear` — Clear the entire cache

### Server Management
- `sccache server start` — Start the sccache daemon
- `sccache server stop` — Stop the sccache daemon

### Passthrough
- `sccache _ _` — Pass raw arguments to sccache binary
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Fix passthrough command example syntax.

sccache _ _ is ambiguous and reads like two placeholder tokens. Document a concrete form users can run (for example, showing raw args after the passthrough route) to prevent failed copy/paste usage.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/sccache/skills/quickstart/SKILL.md` at line 24, Replace the ambiguous
example text "sccache _ _" with a concrete, copy-paste runnable example that
shows the passthrough syntax and an actual argument (for example using a
double-dash separator followed by a real sccache flag such as --version) and
update the accompanying description to state that the passthrough uses "--" to
separate the wrapper from raw sccache arguments; locate the line containing the
string "sccache _ _" in SKILL.md and change it to the concrete example and
explanatory note.


## Usage Examples

```bash
# Check cache stats
sc sccache stats show --json

# Clear cache
sc sccache cache clear

# Use sccache as compiler wrapper
export RUSTC_WRAPPER=sccache
cargo build
sc sccache stats show --json
```
Loading