What problem does it solve? Running Claude Code background agents hold their plugins in memory from the moment they start, so installing or updating a plugin has no effect on agents already running. This Skill restarts those background agents via claude --bg --resume, letting a fresh process load the current plugin versions while preserving each agent's conversation and configuration. ## Core Features & Use Cases - Selective or bulk restart: Restart all idle background agents, target specific agent ids, include busy agents with --force, or scope by working directory with --cwd. - State preservation: Re-applies each agent's original launch flags from ~/.claude/jobs/<id>/state.json, including permission mode, disallowed-tools lists, custom settings, and the agent's goal. - Safe preview: --dry-run reports what would be restarted without touching anything, and interactive terminal sessions are never affected. - Use Case: After updating a plugin in your marketplace, run the restart command so every background agent picks up the new plugin version without losing its in-progress work. ## Quick Start Ask the agent to list running background agents and restart the idle ones so they load the updated plugins.
