Skip to content

fix(claude-relay-plugin): align plugin identity and drop the legacy engine pin - #91

Open
willwashburn wants to merge 2 commits into
mainfrom
claude/agent-relay-skills-review-a8mgtd-plugin-config
Open

fix(claude-relay-plugin): align plugin identity and drop the legacy engine pin#91
willwashburn wants to merge 2 commits into
mainfrom
claude/agent-relay-skills-review-a8mgtd-plugin-config

Conversation

@willwashburn

@willwashburn willwashburn commented Aug 3, 2026

Copy link
Copy Markdown
Member

Summary

Four pieces of the plugin's configuration disagreed with each other. Each is small; together they mean a fresh install points at the wrong engine and the documented install command doesn't resolve.

Engine URL

.mcp.json pinned RELAY_BASE_URL to https://gateway.relaycast.dev. Every default in both repos is https://cast.agentrelay.com:

  • relaycast/packages/sdk-typescript/src/client.ts:172
  • relaycast/packages/sdk-typescript/src/relay.ts:316,368
  • relay/packages/sdk/src/messaging/observer-source.ts:272
  • relay/packages/cli/src/cli/commands/integration.ts:509

and the skills in this repo document cast.agentrelay.com too. Plugin users were being sent to a different engine than everything else in the product. relaycast.dev hosts are also what relaycast-cloud's legacy strangler router is migrating away from.

Removed the pin rather than swapping in the correct host, so the plugin follows the SDK default wherever that moves next instead of needing another fix.

Plugin name

plugin.json declared agent-relay; the directory, the marketplace entry, and package.json all say claude-relay-plugin. Aligned plugin.json to the other three rather than renaming three things to match one.

Worth a second opinion: agent-relay is arguably the nicer user-facing name, and going that direction instead would mean renaming the directory, the marketplace entry, and package.json — and would make the install claude-relay-plugin@agent-relay read as agent-relay@agent-relay. I took the low-risk direction; say the word if you'd rather have the other.

Repository

The marketplace entry claimed the plugin lives in AgentWorkforce/relay, while its own source.url and plugin.json both point at AgentWorkforce/skills — which is where it actually is.

README

Told users to run /plugin marketplace add Agentworkforce/relay. marketplace.json exists only in this repo (find across both confirms it), so that command cannot resolve. Now names the right repo and adds the missing install step.

Part of a series from a review of the Agent Relay skills and plugins.

Test Plan

  • All five touched/related JSON files parse (marketplace.json, plugin.json, .mcp.json, package.json, prpm.json)
  • Verified identifiers now agree: marketplace entry name, plugin.json name, package.json name, and source.path basename are all claude-relay-plugin; both repository fields and source.url point at AgentWorkforce/skills
  • Confirmed cast.agentrelay.com is the default in both SDKs by grepping the relaycast and relay sources
  • Confirmed marketplace.json exists only in this repo, not in relay
  • Fresh /plugin marketplace add + /plugin install against the updated manifest — not run; needs a live Claude Code install. Worth doing before merge since it exercises the renamed plugin identity

Screenshots

n/a


Generated by Claude Code

Review in cubic

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 3a344385-d061-4715-9149-07447fec2cb5

📥 Commits

Reviewing files that changed from the base of the PR and between d40c284 and ea95adc.

📒 Files selected for processing (8)
  • .claude-plugin/marketplace.json
  • README.md
  • plugins/claude-relay-plugin/.claude-plugin/plugin.json
  • plugins/claude-relay-plugin/.mcp.json
  • plugins/claude-relay-plugin/README.md
  • plugins/claude-relay-plugin/hooks/post-tool-inbox.sh
  • plugins/claude-relay-plugin/hooks/stop-inbox.js
  • plugins/claude-relay-plugin/hooks/stop-inbox.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 198cbaa974

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread plugins/claude-relay-plugin/.mcp.json

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 4 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread plugins/claude-relay-plugin/.mcp.json
claude added 2 commits August 20, 2026 11:11
…ngine pin

Four pieces of the plugin's configuration disagreed with each other.

**Engine URL.** `.mcp.json` pinned `RELAY_BASE_URL` to
`https://gateway.relaycast.dev`, a legacy host. Every default in both
repos is `https://cast.agentrelay.com` (relaycast's `client.ts` and
`relay.ts`; relay's `observer-source.ts` and `integration.ts`), and the
skills document that host too. Plugin users were being pointed at a
different engine than everything else. Removed the pin outright rather
than hardcoding the right host, so the plugin follows the SDK default
wherever that moves next.

**Plugin name.** `plugin.json` declared `agent-relay` while the
directory, the marketplace entry, and `package.json` all say
`claude-relay-plugin`. Aligned `plugin.json` to the other three rather
than renaming three things to match one.

**Repository.** The marketplace entry claimed the plugin lives in
`AgentWorkforce/relay`, but its own `source.url` and `plugin.json` both
point at `AgentWorkforce/skills` — which is where it is.

**README.** Told users `/plugin marketplace add Agentworkforce/relay`.
The marketplace manifest only exists in this repo, so that command
cannot resolve. Now names the right repo and adds the install step.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1
Review caught that removing only the MCP server's `RELAY_BASE_URL` pin
splits the plugin across two engines. The `env` block applies to the MCP
subprocess alone, so the separately-launched hooks kept their own
`gateway.relaycast.dev` fallback: on a fresh install the MCP server would
talk to `cast.agentrelay.com` while `post-tool-inbox.sh` and
`stop-inbox.js` queried the legacy host with a token minted by the new
one — silently missing every message and defeating both inbox polling
and the stop guard. That is the same config drift this PR set out to fix.

Updates every remaining default to the SDK's (`cast.agentrelay.com`):
`stop-inbox.ts` and its compiled `stop-inbox.js`, `post-tool-inbox.sh`,
and the two places the plugin README documents the default.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1
@willwashburn
willwashburn force-pushed the claude/agent-relay-skills-review-a8mgtd-plugin-config branch from 198cbaa to ea95adc Compare August 20, 2026 11:12
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