Productivity
kill-claude-mem avatar

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
View on GitHub