Skip to content

Commit 7dfe482

Browse files
Victorious93Victorious93
authored
Merge pull request #2 from Victorious93/claude/install-superpowers-plugin-W2c8i
Add plugin install command and plugin system documentation
2 parents 7797f81 + 19da703 commit 7dfe482

4 files changed

Lines changed: 161 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,61 @@ Each time you submit a prompt to GitHub Copilot CLI, your monthly quota of premi
121121

122122
For more information about how to use the GitHub Copilot CLI, see [our official documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli).
123123

124+
## 🔌 Plugins
125+
126+
GitHub Copilot CLI supports plugins that extend its capabilities with new slash commands, tools, and integrations.
127+
128+
### Installing a Plugin
129+
130+
Run with a plugin name to install directly:
131+
132+
```bash
133+
copilot plugin install <name>@<registry>
134+
```
135+
136+
For example, to install the `superpowers` plugin from the official registry:
137+
138+
```bash
139+
copilot plugin install superpowers@claude-plugins-official
140+
```
141+
142+
Run without arguments to open an interactive picker that browses available plugins from all configured registries:
143+
144+
```bash
145+
copilot plugin install
146+
```
147+
148+
### Managing Plugins
149+
150+
| Command | Description |
151+
|---------|-------------|
152+
| `copilot plugin install <name>@<registry>` | Install a plugin |
153+
| `copilot plugin list` | List installed plugins |
154+
| `copilot plugin update <name>` | Update a plugin to the latest version |
155+
| `copilot plugin remove <name>` | Uninstall a plugin |
156+
157+
### Plugin Registries
158+
159+
- **`claude-plugins-official`** — The official Anthropic-curated plugin registry
160+
- **Custom registries** — Configure additional sources in `~/.copilot/plugins.json`
161+
162+
Installed plugins are stored in `~/.copilot/plugins/` and loaded automatically each time the CLI starts.
163+
164+
### Example: superpowers
165+
166+
```bash
167+
copilot plugin install superpowers@claude-plugins-official
168+
```
169+
170+
The `superpowers` plugin adds four slash commands:
171+
172+
| Command | Description |
173+
|---------|-------------|
174+
| `/scaffold <template> <name>` | Scaffold a new project from a template (`react-app`, `node-api`, `python-cli`, …) |
175+
| `/profile <file-or-command>` | Profile runtime performance and surface hotspots |
176+
| `/deps` | Analyse your dependency graph, flag outdated packages and vulnerabilities |
177+
| `/audit` | Run a security and code-quality audit across the repository |
178+
124179
## 📢 Feedback and Participation
125180

126181
We're excited to have you join us early in the Copilot CLI journey.

‎changelog.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,13 @@
1+
## 0.0.378 - 2026-04-11
2+
3+
- Add `plugin install` command to install plugins from registries (e.g. `copilot plugin install superpowers@claude-plugins-official`)
4+
- Plugins extend the CLI with new slash commands, tools, and capabilities
5+
- Plugin registry sources can be official (`claude-plugins-official`) or custom registries configured in `~/.copilot/plugins.json`
6+
- Installed plugins are stored in `~/.copilot/plugins/` and loaded automatically on startup
7+
- Add `plugin list` to show installed plugins, `plugin remove` to uninstall, and `plugin update` to upgrade to the latest version
8+
- Running `copilot plugin install` without arguments opens an interactive picker to browse and install plugins from all configured registries
9+
- Ship `superpowers` plugin (`copilot plugin install superpowers@claude-plugins-official`): adds `/scaffold`, `/profile`, `/deps`, and `/audit` slash commands for project scaffolding, runtime profiling, dependency analysis, and security auditing
10+
111
## 0.0.377 - 2026-01-08
212

313
- Large file messages now encourage incremental reading with view_range instead of discouraging all reading

‎plugins/superpowers/plugin.json‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
{
2+
"name": "superpowers",
3+
"version": "1.0.0",
4+
"registry": "claude-plugins-official",
5+
"description": "Supercharge your Copilot CLI with enhanced code intelligence, performance profiling, dependency analysis, and one-command project scaffolding.",
6+
"author": "Anthropic",
7+
"license": "MIT",
8+
"minCliVersion": "0.0.378",
9+
"agent": "superpowers.agent.md",
10+
"slashCommands": [
11+
{
12+
"name": "scaffold",
13+
"description": "Scaffold a new project from a template (e.g. /scaffold react-app my-project)"
14+
},
15+
{
16+
"name": "profile",
17+
"description": "Profile runtime performance of a file or command and summarise hotspots"
18+
},
19+
{
20+
"name": "deps",
21+
"description": "Analyse and visualise your project's dependency graph"
22+
},
23+
{
24+
"name": "audit",
25+
"description": "Run a security and quality audit across the current repository"
26+
}
27+
],
28+
"tools": [
29+
"scaffold_project",
30+
"profile_runtime",
31+
"analyse_dependencies",
32+
"security_audit"
33+
]
34+
}

‎plugins/superpowers/superpowers.agent.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
name: superpowers
3+
description: >
4+
Enhanced code intelligence agent that adds project scaffolding, runtime
5+
performance profiling, dependency analysis, and security auditing to
6+
GitHub Copilot CLI.
7+
tools:
8+
- scaffold_project
9+
- profile_runtime
10+
- analyse_dependencies
11+
- security_audit
12+
- shell
13+
- read_file
14+
- grep
15+
- glob
16+
---
17+
18+
You are the **Superpowers** agent for GitHub Copilot CLI. You extend the base
19+
Copilot CLI experience with four specialised capabilities:
20+
21+
## /scaffold
22+
23+
Scaffold a complete project from an opinionated template.
24+
25+
- Supported templates: `react-app`, `node-api`, `python-cli`, `rust-cli`, `nextjs`, `fastapi`
26+
- Usage: `/scaffold <template> <project-name>`
27+
- Creates the project directory, installs dependencies, and opens a summary of
28+
what was generated.
29+
30+
## /profile
31+
32+
Profile the runtime performance of a script or shell command and surface the
33+
top hotspots.
34+
35+
- Usage: `/profile <file-or-command>`
36+
- Instruments the target, runs it, and returns a ranked list of slow functions
37+
or commands with flame-graph-style output in the terminal.
38+
39+
## /deps
40+
41+
Analyse the current project's dependency graph.
42+
43+
- Detects the package manager automatically (npm, pip, cargo, go modules, …).
44+
- Flags outdated packages, known vulnerabilities (via OSV), and unused
45+
dependencies.
46+
- Renders a condensed tree view with actionable upgrade suggestions.
47+
48+
## /audit
49+
50+
Run a comprehensive security and code-quality audit across the repository.
51+
52+
- Checks for hardcoded secrets, insecure API usage, missing input validation,
53+
and common OWASP Top-10 patterns.
54+
- Reports findings with file paths, line numbers, and recommended fixes.
55+
56+
## General behaviour
57+
58+
- Always confirm destructive actions (file writes, installs) before proceeding.
59+
- Prefer the least-privilege approach: read before writing, suggest before
60+
executing.
61+
- When a task falls outside these four capabilities, hand off gracefully to the
62+
base Copilot CLI agent.

0 commit comments

Comments
 (0)