self-reload-plugins

Dispatch /reload-plugins to a macOS terminal window via AppleScript.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/EthanSK/claude-skill-self-reload-plugins-mac --skill self-reload-plugins
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-reload-plugins
Source: https://github.com/EthanSK/claude-skill-self-reload-plugins-mac/tree/main
Command: npx skills add https://github.com/EthanSK/claude-skill-self-reload-plugins-mac --skill self-reload-plugins

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

When an MCP server or plugin disconnects mid-session while using Claude Code, you have to manually switch to the terminal and type /reload-plugins to restore functionality, which breaks your workflow. This skill eliminates that manual step by automatically triggering the reload command for you.

Core Features & Use Cases

  • Automatic MCP Recovery: Detects when expected MCP tools or plugins go missing or stop responding, and triggers the reload process without user intervention.
  • Multi-Terminal Support: Works with iTerm2, Terminal.app, Ghostty, WezTerm, kitty, and Alacritty on macOS, using the most reliable interaction method for each terminal type.
  • Safe Execution: Uses a two-tier matching system (process tty first, then window title) and omits blind frontmost keystroke fallbacks to ensure the reload command never lands in the wrong application.
  • Use Case: If your chrome-devtools MCP plugin crashes mid-task, this skill will automatically send /reload-plugins to your Claude terminal to restore the tool in seconds, no manual input needed.

Quick Start

Use the self-reload-plugins skill to automatically reload your MCP plugins when they disconnect mid-session without you typing any commands into the terminal.

Frequently Asked Questions about self-reload-plugins

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically reload MCP plugins in Claude Code when they disconnect mid-session?

To automatically reload MCP plugins, you can use a skill that detects disconnections and dispatches the /reload-plugins command directly to your running macOS terminal window via AppleScript, restoring functionality hands-free without manual input.

Why do MCP servers stop responding in Claude Code and how can I recover them?

MCP servers may stop responding due to mid-session disconnects or plugin crashes. You can recover them by sending the /reload-plugins command to your terminal, which an automation skill can trigger automatically using System Events on macOS.

Does the automatic MCP plugin recovery work with iTerm2 and other macOS terminal emulators?

Yes, automatic MCP plugin recovery works with iTerm2, Terminal.app, Ghostty, WezTerm, kitty, and Alacritty on macOS, using the most reliable AppleScript interaction method supported by each specific terminal emulator.

What is the safest way to send terminal commands to Claude Code without affecting other applications?

The safest way to send terminal commands is using a two-tier matching system that identifies the target terminal window by process tty and window title first, omitting blind frontmost keystroke fallbacks to ensure commands never inject into unrelated applications.

What are the limitations of automatically reloading MCP plugins on macOS?

Limitations of automatically reloading MCP plugins include requiring macOS with AppleScript and System Events, and your target Claude terminal window must include "Claude" in its title for accurate matching, as blind keystroke fallbacks are intentionally omitted for safety.

Do I need to manually type /reload-plugins when an MCP server crashes in Claude Code?

No, you do not need to manually type /reload-plugins when an MCP server crashes. Automation skills can detect the disconnection and dispatch the reload command directly to your terminal window to restore your tools automatically.