Skip to content

Publish the Claude plugin to a claude-plugin branch - #465

Merged
scottlangille merged 3 commits into
mainfrom
claude-plugin-branch
Oct 27, 2026
Merged

scottlangille merged 3 commits into
mainfrom
claude-plugin-branch

Conversation

@scottlangille

@scottlangille scottlangille commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add a workflow that publishes plugins/exa to the root of a claude-plugin branch on each package version bump on main, as one commit on top of the previous one. The first run, which merging this PR triggers, creates the branch. A manual run publishes a plugin-only change between releases and does nothing when the branch already matches.
  • Replace the SVG plugin icon with a 1024×1024 PNG.

Claude's plugin directory reads the plugin from a fixed path in this repository. Tracking claude-plugin gives it the plugin without the server's package files and source.

Testing

  • Ran both workflow steps against a local remote: this PR's merge creates the branch with a tree identical to main:plugins/exa; a workflow-only edit and a package.json change without a version bump skip; a version bump publishes a new commit; a manual run with nothing new does nothing
  • claude plugin validate on the published branch root
  • actionlint, npm run ci

Claude's plugin directory reads a plugin from a fixed path in its
repository, here the root. A workflow now publishes plugins/exa to the
root of a claude-plugin branch on each change, so the directory can track
that branch and see only the plugin.

- Add the publish workflow. It commits the plugins/exa tree onto the
  branch and skips the push when nothing changed.
- Replace the SVG icon with a 1024x1024 PNG, the format the directory
  accepts.

Assisted-by: Claude Code:claude-opus-5-5
@scottlangille
scottlangille requested a review from kesku October 27, 2026 22:38
@kesku
kesku force-pushed the claude-plugin-branch branch from 8594e44 to 58a396d Compare October 27, 2026 22:53
kesku and others added 2 commits October 27, 2026 22:53
The workflow publishes on package version bumps, so merging it alone
would not create the branch. It now also runs when the workflow file
changes and publishes whenever the branch does not exist yet.

- Restore the header comment on why the branch exists and how to publish
  a plugin-only change.
- Describe the version-bump trigger in the README.

Assisted-by: Claude Code:claude-opus-5-5
@scottlangille
scottlangille merged commit e5b1baf into main Oct 27, 2026
1 check passed
@kesku
kesku deleted the claude-plugin-branch branch November 5, 2026 23:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants