fix: surface installed plugin components at ZCode user scope - #25
Merged
Conversation
ZCode 3.3.6 loads user skills, commands, and agents only from ~/.zcode/skills, ~/.zcode/commands, and ~/.zcode/agents; it never reads ~/.zcode/marketplaces/<mp>/plugins/. The installer built a complete ~/.zcode but left every plugin's components inside the marketplace tree, so a headless install placed files the client loaded from nothing -- the setup appeared to install yet none of its skills or commands showed up. The build now surfaces each installed plugin's skills/commands/agents at user scope while keeping the marketplace tree intact for the plugin model and any later UI-managed install. A name collision between two plugins, or between a plugin and a direct user-scope component, fails closed rather than silently shadowing one, which matters as setups grow to many plugins. remove still backs up and deletes the whole managed ~/.zcode, so uninstall stays clean. Verified in an isolated target: install surfaces all 13 builder skills, 13 commands, and the reviewer agent at user scope; the ZCode CLI then loads them (`zcode skills list` / `commands list`); remove leaves no residue. Claude-Session: https://claude.ai/code/session_01Y29c9sJRhChvxDcUjab5Xo
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
ZCode 3.3.6 loads user skills/commands/agents only from
~/.zcode/skills,~/.zcode/commands,~/.zcode/agents— it never reads~/.zcode/marketplaces/<mp>/plugins/. The installer built a complete~/.zcodebut left every plugin's components inside the marketplace tree, so a headless install placed files the client loaded from nothing: the setup appeared to install, yet none of its skills or commands showed up in ZCode.(Confirmed against a real ZCode 3.3.6 install:
zcode skills list/plugins listshowed none of our content; ZCode's built-in guide documents the user-scope + UI-only-marketplace loading; its CLI has noplugin add, so file-based marketplace install isn't possible — unlike Codex, which the installer correctly drives throughcodex plugin add.)Fix
The build now surfaces each installed plugin's
skills/commands/agentsat user scope (~/.zcode/{skills,commands,agents}) while keeping themarketplaces/<mp>/tree intact for the plugin model and any later UI-managed install. A name collision (two plugins, or a plugin vs a direct user-scope component) fails closed rather than silently shadowing one — important as setups grow to many plugins.removestill backs up and deletes the whole managed~/.zcode, so uninstall stays clean.Verification
Isolated target: install surfaces all 13 builder skills + 13 commands + the reviewer agent at user scope; the ZCode CLI then loads them (
zcode skills list/commands list);removeleaves no residue. Private harness: the full nddev-zcode-app slice passes, including a newtest_install_surfaces_plugin_components_at_user_scope.https://claude.ai/code/session_01Y29c9sJRhChvxDcUjab5Xo