whynowlab

zclean

Name: zclean
Author: whynowlab

Development community intermediate

SOURCE https://github.com/TheStack-ai/zclean

Description

███████ ██████ ██ ███████ █████ ███ ██ ╚══███ ██ ██ ██ ██ ██ ████ ██ ███ ██ ██ █████ ███████ ██ ██ ██ ███ ██ ██ ██ ██ ██ ██ ██ ██ ███████ ██████ ███████ ███████ ██ ██ ██ ████

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

zclean — Zombie Process Cleaner for AI Coding Tools

**Stop AI coding tools from eating your RAM.**

[](https://www.npmjs.com/package/@thestackai/zclean) [](https://www.npmjs.com/package/@thestackai/zclean) [](https://opensource.org/licenses/MIT) [](#) [](#) [](#) [](#) [](https://github.com/TheStack-ai/zclean) [](https://github.com/rohitg00/awesome-claude-code-toolkit)

Quick Demo

AI coding tools spawn child processes — MCP servers, sub-agents, headless browsers, build watchers. When the session ends or crashes, those children don't always exit. They pile up silently, draining RAM until your machine grinds to a halt.

**Before**

$ zclean

  zclean — scanning for zombie processes...

  Found 12 zombie processes:

    PID 26413  node         367 MB  (orphan, 18h)  was: claude mcp-server
    PID 62830  chrome       200 MB  (orphan, 3h)   was: agent-browser
    PID 26221  npm          142 MB  (orphan, 2d)   was: npm exec task-master-ai
    PID 23096  node         355 MB  (orphan, 6h)   was: claude sub-agent
    ... 8 more

  Total: 12 zombies, ~2.4 GB reclaimable

  Run `zclean --yes` to clean.

**After**

$ zclean --yes

  zclean — scanning for zombie processes...

  Cleaned 12 zombie processes. Reclaimed ~2.4 GB.

  zclean status:
    Protection: active
    SessionEnd hook: registered
    Hourly scheduler: running

Why zclean?

Claude Code, Codex, and other AI coding tools spawn dozens of child processes per session: MCP servers, sub-agents, headless Chromium instances, esbuild watchers, and more. When the parent session exits — especially on crash or force-quit — these children become orphans.

...