Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.274 ·

Plugins can register custom agents at runtime

Plugins can now register their own custom agents, which get merged into the session's available agents automatically

TierUnder the hoodhow much it should matter to you
Useful2my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaSDKwhat it touches
KindInternal Changesin v2.1.274,
Group of 4 Under the hood No documentation found

Plugins can now register their own custom agents, which get merged into the session's available agents automatically

What

  • Plugins gain a new function hook, register_agent (alongside the existing hooks for registering commands and tools), letting a plugin define a custom agent.
  • The plugin SDK exposes an agent.register call that takes a name, description, and prompt (plus other fields), validating that the name only contains letters, digits, underscores, or hyphens and is no longer than 64 characters.
  • Agents registered this way at runtime are merged into the session's list of available agents, tagged as coming from a plugin (source: "plugin", registeredAtRunTime: true).
  • The session/engine layer gains a refreshAgents method, mirroring the existing refreshCommands, to re-read custom agent definitions on demand.

Why This lets plugins extend Claude Code with their own specialized agents without requiring a restart, the same way plugins can already register custom commands and tools.

Read from
Names in the bundlerefreshAgents

See this entry in the whole of v2.1.274 →

Feedback