{"version":"2.1.228","anchor":"headless-plugin-install-refreshes-the-plugin-cache-in-the-ba","canonical_anchor":"headless-plugin-install-refreshes-the-plugin-cache-in-the-ba","heading":"Headless plugin install refreshes the plugin cache in the background","tier":"use","area":"Plugins","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.228\/e\/headless-plugin-install-refreshes-the-plugin-cache-in-the-ba","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.228","markdown":"### Headless plugin install refreshes the plugin cache in the background\n\nHeadless plugin installs refresh the cache in the background; set CLAUDE_CODE_SYNC_PLUGIN_INSTALL to skip it.\n\n**What**\n\nInstalling plugins in headless mode now re-fills the plugin cache after each change instead of leaving it stale, without blocking the install. Set `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` to skip the background work entirely; it is also skipped when a cache-only load is already pinned.\n\n**Details**\n\n- The re-fill is tracked so a later pass can tell whether the current cache came from its own refresh.\n- A failed refresh logs a tagged message rather than rejecting and failing the install.\n\n**Evidence**\n\n`headlessPluginInstall: plugins changed`\n\n- Area: Plugins\n- Names: `CLAUDE_CODE_SYNC_PLUGIN_INSTALL`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 3\/5"}