docs: correct the plugin install steps in the README - #23
Merged
Conversation
Installing the plugin does not need a Claude Code restart; /reload-plugins registers the server in the running session. Name it, along with the `claude mcp list` entry that confirms the result. Add the two things a first install trips over: installing the plugin and running `claude mcp add` registers the same server twice, and the plugin exposes its tools under `mcp__plugin_ctxpack_ctxpack__*`, which permission rules have to match. The CTXPACK_BIN troubleshooting step told the reader to edit an `env` block that a plugin install gives them no copy of. Point at the environment or at manual registration instead. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.
Verified the plugin install path end to end on a real machine and found three places the README was off.
/reload-pluginsregisters the MCP server in the running session. The README said to restart Claude Code. Addedclaude mcp listas the confirmation step, along with the name the entry takes (plugin:ctxpack:ctxpack).claude mcp add ctxpackregisters the same server twice, so the agent sees two of every tool. Called out that the two paths are alternatives. Also noted that plugin-provided tools are namedmcp__plugin_ctxpack_ctxpack__pack, notmcp__ctxpack__pack— permission rules have to match that.CTXPACK_BINtroubleshooting step had no exit for plugin users. It told the reader to add anenvblock to.mcp.json, but the plugin's config ships inside this repository and the user has no copy to edit. Points at the process environment or manual registration now.Also added the
-s uservariant ofclaude mcp add, since registering once for every project is the common case.Docs only — no code, no config changes. Plugin manifests were checked and are correct as-is: the marketplace name
nandemo-yaand plugin namectxpackmatch the documented/plugin install ctxpack@nandemo-ya, and the two version fields agree at 0.1.0.🤖 Generated with Claude Code