kill-claude-mem
Kills stale claude-mem worker and MCP server processes to recover RAM and improve performance in memory-constrained environments like GitHub Codespaces.
Introduction
This diagnostic and maintenance skill is designed to manage memory leaks associated with the claude-mem plugin architecture. Because claude-mem often spawns worker-service and mcp-server instances per session that persist even after the session terminates, users may experience degraded system performance, system lag, or memory exhaustion (OOM) over extended periods of usage, particularly within resource-constrained environments like cloud-based development containers. By invoking this skill, the system clears zombie processes, allowing the plugin's internal hooks to trigger a clean, fresh initialization of necessary background services upon the subsequent tool interaction.
-
Automatically identifies and terminates leaked worker-service and mcp-server processes.
-
Provides immediate visual feedback on memory recovery status and system resource health.
-
Includes an integrated session-start hook installation script for automated lifecycle management.
-
Essential for power users running heavy-duty LLM-integrated development environments.
-
Compatible with any project repository utilizing the .claude skill directory structure.
-
Execute the skill when experiencing noticeable latency in IDE responsiveness or system-level memory pressure.
-
Run free -h after execution to verify that physical RAM usage has decreased as expected.
-
Use the provided install-hook.sh to ensure the cleanup process is persistent across future development sessions.
-
Note that this tool does not delete configuration files or project data; it only targets orphaned process IDs.
-
Requires bash and jq for installation and operation; ideal for Linux and macOS environments.
-
Serves as a critical utility for maintaining a lightweight, performant environment during complex engineering workflows.
Repository Stats
- Stars
- 17
- Forks
- 4
- Open Issues
- 2
- Language
- HTML
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 3, 2026, 11:07 PM