A CLI tool to list and kill background Node.js processes
npm install node-pkill-processA CLI tool to list and kill Node.js processes running in the background.
This project was initially created with the assistance of Qwen Code, an AI coding assistant, during a live coding session. The tool has been developed to help users manage background Node.js processes efficiently.
``bash`
npm install
Run with:
`bash`
npm start
Or if you prefer to use it directly:
`bash`
node src/index.js
`bash`
npm install -g node-pkill-process
After installation, you can use the tool with the pkill-process command from any directory:
`bash`
pkill-process
To uninstall globally:
`bash`
npm uninstall -g node-pkill-process
`bash``
npx node-pkill-process
This downloads and runs the package instantly without requiring a local installation.
- Lists all Node.js processes running in the background
- Displays PID, command, CPU usage, and memory
- Allows you to select and terminate individual processes
- Group processes by project and terminate all processes from the same project
- Safely terminates processes with SIGTERM, and if necessary with SIGKILL
- Choose between individual process management or project-based grouping
- Configurable project mappings, blacklists, and whitelists through configuration file
- Support for complex applications with multiple related processes (e.g., LM Studio, VS Code, Electron apps)
This tool is designed to help you manage background Node.js processes. Be careful when terminating processes, as you might interrupt important applications. Use at your own risk.
MIT