{"version":"2.1.301","anchor":"reload-plugins-control-request-gains-add-plugins","canonical_anchor":"reload-plugins-control-request-gains-add-plugins","heading":"reload_plugins can now add plugins mid-session","tier":"use","area":"SDK","scope":"individual","heads_up":true,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.301\/e\/reload-plugins-control-request-gains-add-plugins","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.301","markdown":"### reload_plugins can now add plugins mid-session\n\nThe SDK reload_plugins request takes add_plugins to load extra plugin folders without restarting, refused in cloud sessions and under disableSideloadFlags\n\n**What**\n\nA plugin is an add-on package for Claude Code. Programs that drive Claude Code through the SDK (its developer kit) send a `reload_plugins` request to reload plugins. That request now takes an optional `add_plugins` list:\n\n- Each entry is `{ type: \"local\", path }` with an absolute path, the same shape as the SDK `plugins` option. It joins the session as one more `--plugin-dir` would, and plugins already loaded stay loaded.\n\n- The plugins are installed before the reload, optionally without looking for their MCP servers.\n\n- If the reload is held because it would affect the cache, or it fails, the added plugins are undone.\n\n- Refusals come back with an error message. The request is refused for callers on another machine, when managed settings set `disableSideloadFlags`, for Remote Control and cloud workers, in cloud-hosted sessions (which used to let it through), and with `sandbox_deny_failed` when a running sandbox, the protective boundary around commands Claude runs, cannot keep shell commands out of the new folders.\n\nAlso changed:\n\n- `mcp_call` accepts `result_not_for_model`, passed on as `resultNotForModel`. It is ignored on connections that do not redact.\n\n- A settings pins result now includes `settingsFiles`, and a change summary tracks changes to `agentProxy`.\n\n**Why**\n\nA host program can add plugins to a running session without restarting it. Organizations that block sideloaded plugins with `disableSideloadFlags` also block this route.\n\n- Area: SDK\n- Names: `add_plugins`, `reload_plugins`, `--plugin-dir`\n- Tier: Use it now\n- Useful: 5\/5\n- Signal: 3\/5\n- Scope: individual\n- Heads-up: yes"}