plugnz 0.0.12 → 0.0.14
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 +16 -2
- package/dist/plugnz.mjs +4298 -1911
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -7,6 +7,8 @@ npx plugnz add <plugin-dir-or-marketplace-or-git-url> # native plugin stores
|
|
|
7
7
|
npx plugnz doctor # dead commands, shadowed entries, stale installs
|
|
8
8
|
npx plugnz pin # absolute command paths for GUI hosts
|
|
9
9
|
npx plugnz update # re-add from the recorded source, re-pin
|
|
10
|
+
npx plugnz sync --manifest desired.json # converge complete Desired sets; retire owned orphans
|
|
11
|
+
npx plugnz scopes --json # inspect recorded sources, scopes and retained history
|
|
10
12
|
```
|
|
11
13
|
|
|
12
14
|
`pin` rewrites a plugin's bare stdio `command` to the absolute path it resolves
|
|
@@ -18,8 +20,20 @@ tool did not install. Details: `docs/pin-and-update.md`.
|
|
|
18
20
|
|
|
19
21
|
Why another tool: `npx plugins` is closed-source and its Cursor target does not install into Cursor; nothing in the ecosystem checks that an installed plugin still *works*. See `docs/research/`.
|
|
20
22
|
|
|
21
|
-
The
|
|
23
|
+
The published CLI runs under Node.js 22 or newer; `npx` needs npm, not Bun. `bunx` also works. Bun is used for development and building. `add` accepts a local plugin or marketplace directory as well as a Git URL. Native plugin targets currently include Claude Code, Codex, Kimi, Cursor, OMP, Hermes, Grok, DCode, and ZCode CLI. Run `plugnz targets --all` to see supported and unsupported capabilities for each host; standalone skill distribution is outside this CLI's scope.
|
|
24
|
+
|
|
25
|
+
`sync` tracks each Source and its complete Desired plugin set per host. It retires
|
|
26
|
+
owned plugins omitted from that set while retaining plugin data, inactive metadata
|
|
27
|
+
and lifecycle history. A missing or invalid Source is an error, never permission
|
|
28
|
+
to prune. Use an explicit `retire-source` manifest entry when the Source itself
|
|
29
|
+
is gone. See [the batch manifest](docs/sync-manifest.md).
|
|
30
|
+
|
|
31
|
+
General sync/update/retirement is supported. Interrupted legacy installs needing
|
|
32
|
+
the unfinished fenced adoption transaction are refused loudly without writes;
|
|
33
|
+
successful legacy migration and stronger cross-process exclusion are follow-up
|
|
34
|
+
refinements, not delivered guarantees.
|
|
22
35
|
|
|
23
36
|
Published on npm as `plugnz`; source repository: `archeism/plugnz`.
|
|
24
37
|
|
|
25
|
-
Maintainers: see [publishing instructions](docs/publishing.md)
|
|
38
|
+
Maintainers: see [publishing instructions](docs/publishing.md). Pushes to `main`
|
|
39
|
+
automatically publish the next patch after local verification.
|