@hmanlab/hl-plugins 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +57 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# @hmanlab/hl-plugins
|
|
2
|
+
|
|
3
|
+
Install curated [OpenCode](https://opencode.ai) plugins with one command.
|
|
4
|
+
|
|
5
|
+
[](https://github.com/hmanlab/hl-plugins/actions/workflows/ci.yml)
|
|
6
|
+
[](https://www.npmjs.com/package/@hmanlab/hl-plugins)
|
|
7
|
+
[](./LICENSE)
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g @hmanlab/hl-plugins
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Or invoke directly via `npx` (no global install needed):
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx -y @hmanlab/hl-plugins install mmx
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Usage
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
hl-plugins install [plugin] # install one or all default plugins
|
|
25
|
+
hl-plugins uninstall [plugin] # remove plugin(s)
|
|
26
|
+
hl-plugins list # show known plugins + install state
|
|
27
|
+
hl-plugins status [plugin] # per-plugin diagnostic report
|
|
28
|
+
hl-plugins update [plugin] # re-copy files + bump dependencies
|
|
29
|
+
hl-plugins help # show all commands
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
The install flow is **idempotent** and the config merge is **additive** —
|
|
33
|
+
your other OpenCode plugins, MCP servers, providers, and permission
|
|
34
|
+
settings are left untouched.
|
|
35
|
+
|
|
36
|
+
## Available plugins
|
|
37
|
+
|
|
38
|
+
| Plugin | Description | Requires |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| [`@hl-plugins/mmx`](https://github.com/hmanlab/hl-plugins/tree/main/packages/plugin-mmx) | Image, video, music, speech, search, vision, and quota via MiniMax | [`mmx-cli`](https://github.com/MiniMax-AI/cli) + MiniMax Token Plan |
|
|
41
|
+
|
|
42
|
+
To install a plugin's dependency, the CLI runs the contract's `requires[].install`
|
|
43
|
+
for you (e.g. `npm install -g mmx-cli`). When the plugin needs credentials,
|
|
44
|
+
the install flow prompts for the API key (input is hidden) or accepts
|
|
45
|
+
`--key` / the contract's `auth.envVar` for CI/automation.
|
|
46
|
+
|
|
47
|
+
## Documentation
|
|
48
|
+
|
|
49
|
+
Full docs live in the [monorepo](https://github.com/hmanlab/hl-plugins):
|
|
50
|
+
|
|
51
|
+
- [Architecture](https://github.com/hmanlab/hl-plugins/blob/main/docs/architecture.md) — install flow, plugin contract
|
|
52
|
+
- [Command reference](https://github.com/hmanlab/hl-plugins/blob/main/docs/commands.md) — every flag and exit code
|
|
53
|
+
- [Adding a plugin](https://github.com/hmanlab/hl-plugins/blob/main/docs/adding-a-plugin.md) — drop a folder, no CLI changes needed
|
|
54
|
+
|
|
55
|
+
## License
|
|
56
|
+
|
|
57
|
+
MIT
|