fix: plugin.json format and install docs#4
Open
bryant24hao wants to merge 1 commit intokavanaghpatrick:mainfrom
Open
fix: plugin.json format and install docs#4bryant24hao wants to merge 1 commit intokavanaghpatrick:mainfrom
bryant24hao wants to merge 1 commit intokavanaghpatrick:mainfrom
Conversation
The `repository` field used npm-style object format which fails Claude Code's plugin validation (expects string). This caused `claude plugin install` to silently fail with exit code 1. Also fixes README install instructions to use actual CLI commands and adds Python/jq version pre-flight checks in session-setup hook. Co-Authored-By: Claude Opus 4.6 <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.
Summary
repositoryfield in plugin.json — was using npm-style object{"type": "git", "url": "..."}, but Claude Code plugin validation expects a plain string. This causedclaude plugin installto silently fail with exit code 1 and no error output./install-plugin(which doesn't exist) with the actual CLI commands (claude plugin marketplace add+claude plugin install).session-setup.sh— macOS ships with Python 3.9.6 by default, but the analysis scripts require 3.10+. The hook now warns users at session start instead of failing silently during dispatch.Context
Encountered these issues while installing the plugin on macOS (Darwin 25.2.0). The plugin.json validation error was the main blocker — it took manual
claude plugin validateto diagnose since the install command produces no error output on failure.Test plan
claude plugin validateon the updated plugin.jsonclaude plugin install ralph-parallel@ralph-parallelsucceeds on a fresh install🤖 Generated with Claude Code