killclaudevandamme
v1.0.0
Published
Kill stale Claude processes with precision - memory management for Claude Code CLI
Maintainers
Readme
killclaudevandamme
"Time to clean house." - Claude Van Damme
Kill stale Claude processes with precision. A memory management tool for Claude Code CLI users.
Installation
npm install -g killclaudevandammeFeatures
- Process categorization: Sessions, Subagents, MCP servers, iOS Simulator
- Memory reporting: Swap usage, RAM breakdown, recommendations
- Safe defaults: Never kills Claude Desktop app or current session
- Dry-run mode: Preview what would be killed
- Claude Code integration: Use as
/killclaudevandammecommand
Usage
Terminal
# Show help
killclaudevandamme --help
# List all Claude processes
killclaudevandamme --list
# Show memory report with recommendations
killclaudevandamme --report
# Interactive mode (default)
killclaudevandamme
# Kill stale subagents (>1 hour old)
killclaudevandamme --stale
# Kill MCP servers (chrome-devtools, claude-in-chrome)
killclaudevandamme --mcp
# Kill iOS Simulator processes
killclaudevandamme --sim
# Kill all Claude CLI processes (not Desktop app)
killclaudevandamme --all
# Dry run - show what would be killed
killclaudevandamme --dry-run --allClaude Code
/killclaudevandamme # Interactive
/killclaudevandamme list # List processes
/killclaudevandamme report # Memory report
/killclaudevandamme stale # Kill stale
/killclaudevandamme mcp # Kill MCP servers
/killclaudevandamme sim # Kill iOS SimulatorOptions
| Flag | Short | Description |
|------|-------|-------------|
| --interactive | -i | Interactive mode - select which to kill (default) |
| --stale | -s | Kill subagent processes older than 1 hour |
| --mcp | -m | Kill MCP servers (chrome-devtools, etc.) |
| --sim | -S | Kill iOS Simulator processes |
| --all | -a | Kill all Claude CLI processes |
| --report | -r | Show memory usage report |
| --list | -l | List all Claude processes |
| --dry-run | -n | Show what would be killed without killing |
| --quiet | -q | Minimal output |
| --help | -h | Show help |
Process Categories
| Category | Color | Description |
|----------|-------|-------------|
| [SESSION] | Green | Active terminal sessions (claude continue) |
| [SUBAGENT] | Blue | Background worker processes |
| [MCP] | Cyan | MCP server processes |
| [SIMULATOR] | Red | iOS Simulator processes |
| [DESKTOP] | Yellow | Claude Desktop app (protected) |
Safety
- Never kills current session or parent process
- Never kills Claude Desktop app (marked as protected)
- Graceful shutdown first for iOS Simulator (
xcrun simctl shutdown) - Dry-run available to preview actions
Requirements
- macOS or Linux
- Bash shell
- Node.js >= 14.0.0 (for npm installation)
License
MIT
