killclaudevandamme

> "Time to clean house." - Claude Van Damme

Kill stale Claude processes with precision. A memory management tool for Claude Code CLI users.

Installation

``bash
npm install -g killclaudevandamme
`

Features

- 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 /killclaudevandamme command

Usage

$3

`bash


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 --all
`

$3

`
/killclaudevandamme # Interactive
/killclaudevandamme list # List processes
/killclaudevandamme report # Memory report
/killclaudevandamme stale # Kill stale
/killclaudevandamme mcp # Kill MCP servers
/killclaudevandamme sim # Kill iOS Simulator
`

Options

| 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