claude-code - 💡(How to fix) Fix [BUG] Plugin subagent namespace prefix stripped when launching subagent [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49713Fetched 2026-04-17 08:33:30
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
Timeline (top)
labeled ×3commented ×1

Error Message

● code-reviewer(Review multi-folio PMS changes) ⎿ Initializing… ⎿ Error: Agent type 'code-reviewer' not found. Available agents: general-purpose, statusline-setup, Explore, Plan, ...

Root Cause

The OpenCode framework defines agents with short names ("code-reviewer" in .opencode/opencode.json), but the Claude Code agent system requires fully-qualified names ("everything-claude-code:code-reviewer"). There's a mismatch in how the subagent orchestration layer resolves plugin-provided agent types.

Fix Action

Workaround

Manually invoke code review using the correct agent type:

  • everything-claude-code:code-reviewer for immediate code quality review
  • superpowers:code-reviewer for plan compliance review

Code Example

● code-reviewer(Review multi-folio PMS changes)
Initializing…
Error: Agent type 'code-reviewer' not found. Available agents: general-purpose, statusline-setup, Explore, Plan, ...

---

{"agentType":"everything-claude-code:code-reviewer","description":"Review multi-folio PMS changes"}
RAW_BUFFERClick to expand / collapse

Bug Description

When a plugin-provided subagent (e.g., from everything-claude-code:code-reviewer) is spawned, the metadata correctly stores the fully-qualified agent type, but when the system attempts to launch/restore the subagent, it incorrectly strips the namespace prefix and looks for a non-existent bare agent type.

Steps to Reproduce

  1. Install everything-claude-code plugin
  2. Trigger a code review (e.g., through auto-invocation or manual trigger)
  3. Observe the subagent creation:
    • Metadata stores: "agentType":"everything-claude-code:code-reviewer"
    • System tries to launch: "code-reviewer" (namespace stripped) ✗

Expected Behavior

The subagent should be launched using the fully-qualified agent type (everything-claude-code:code-reviewer) as stored in the metadata.

Actual Behavior

● code-reviewer(Review multi-folio PMS changes)
  ⎿  Initializing…
  ⎿  Error: Agent type 'code-reviewer' not found. Available agents: general-purpose, statusline-setup, Explore, Plan, ...

Root Cause

The OpenCode framework defines agents with short names ("code-reviewer" in .opencode/opencode.json), but the Claude Code agent system requires fully-qualified names ("everything-claude-code:code-reviewer"). There's a mismatch in how the subagent orchestration layer resolves plugin-provided agent types.

Environment

  • Claude Code version: Latest (2026-04-17)
  • Plugin: everything-claude-code@everything-claude-code (enabled)
  • Affected agent types: All plugin-provided subagents (code-reviewer, go-reviewer, python-reviewer, etc.)

Workaround

Manually invoke code review using the correct agent type:

  • everything-claude-code:code-reviewer for immediate code quality review
  • superpowers:code-reviewer for plan compliance review

Additional Context

Metadata file content:

{"agentType":"everything-claude-code:code-reviewer","description":"Review multi-folio PMS changes"}

The metadata is correct, but the launch logic strips the namespace prefix.

extent analysis

TL;DR

Update the subagent orchestration layer to preserve the fully-qualified agent type when launching plugin-provided subagents.

Guidance

  • Verify that the metadata stores the correct fully-qualified agent type by checking the agentType field in the metadata JSON file.
  • Check the OpenCode framework's agent definition in .opencode/opencode.json to ensure it matches the expected short name format.
  • Consider modifying the subagent orchestration layer to handle both short and fully-qualified agent type names to resolve the mismatch.
  • Use the provided workaround to manually invoke code review with the correct agent type until a permanent fix is implemented.

Example

No code snippet is provided as the issue does not imply a specific code change, but rather a modification to the subagent orchestration layer's logic.

Notes

The solution may require updates to the Claude Code framework or the plugin to ensure compatibility and correct handling of fully-qualified agent types.

Recommendation

Apply workaround: Manually invoke code review using the correct agent type (e.g., everything-claude-code:code-reviewer) until the subagent orchestration layer is updated to preserve the fully-qualified agent type.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [BUG] Plugin subagent namespace prefix stripped when launching subagent [1 comments, 2 participants]