proclean

Interactive orphan process killer powered by fzf.

Why proclean?

Closing tmux panes often leaves subprocess orphans (Claude Code, node, cargo, etc.) running with PPID=1, silently consuming memory. On macOS, PPID=1 also includes legitimate launchd-managed processes, so blindly killing everything is dangerous. proclean provides safe, filterable, interactive cleanup.

Features

• Two modes -- dev (whitelist: Claude Code, node, cargo, rbenv) and all (blacklist: system processes only)
• fzf-powered UI -- Fuzzy search, multi-select, real-time preview
• Detail preview -- Process info, command line, open files in side pane
• Safe kill -- SIGTERM with automatic list reload
• Catppuccin Frappe theme -- Consistent color scheme

Prerequisites

• fzf (>= 0.57)

brew install fzf

Installation

# npx で即実行（インストール不要）
npx proclean

# またはグローバルインストール
npm install -g proclean

Usage

# dev mode (default): Claude Code, node, cargo, rbenv orphans
proclean

# all mode: everything except /System, /usr, /Library/Apple
proclean -a

tmux integration

Bind to a key for quick access:

bind P display-popup -E -w 50% -h 50% "proclean"

Keybindings

| Key | Action | |-----|--------| | TAB | Toggle selection | | Enter | Kill selected processes | | Ctrl-A | Select / deselect all | | Ctrl-C | Quit | | Type to search | Fuzzy filter |

Filter Logic

dev mode (default)

Whitelist -- only shows orphans matching:

• .local/share/claude (Claude Code)
• .npm, .nvm, .nodebrew (Node.js)
• .cargo (Rust)
• .rbenv (Ruby)
• Standalone node processes
• bash/zsh spawned by Claude (.claude/ in args)

all mode (-a)

Blacklist -- shows everything except:

• /System/*
• /usr/*
• /Library/Apple/*

Tech Stack

• fzf (interactive UI)
• meow (CLI args)
• tsup (ESM build)

Development

git clone https://github.com/gunubin/proclean.git
cd proclean
npm install && npm run build
npm link

License

MIT