1.1.0 ⢠Published 6 months ago
death-cli v1.1.0
Death CLI
A command-line interface (CLI) tool for managing system processes. Death provides both an interactive mode and command-line options for listing and killing processes.
ā ļø Important Disclaimer
This tool is intended for process management purposes only using a play on words. If you're experiencing thoughts of self-harm or harming others, please seek help immediately. You are not alone, and there are professionals ready to help:
- National Suicide Prevention Lifeline (US): 988 or 1-800-273-8255
- Crisis Text Line: Text HOME to 741741
Please consult with a licensed medical professional or mental health provider for proper care and treatment in a safe controlled environment. Your life has value, and help is available 24/7.
Features
- š List all running processes with details (PID, CPU%, Memory%, Command)
- ā” Kill processes by PID
- š„ļø Interactive mode with a user-friendly interface
- š Formatted table output for better readability
Installation
Local Development Setup
- Clone the repository:
git clone https://github.com/bittricky/death-cli.git
cd death
- Install dependencies:
npm install
- Link the package locally (optional):
npm link
Usage
Running Locally
# Using npm scripts
npm run dev # Start in interactive mode
npm start # Alternative way to start
# If globally linked
death # Start in interactive mode
Command Line Options
# Show help
death --help
# List all processes
death -l
death list
# Kill a process by PID
death -k <pid>
death kill <pid>
# Run in interactive mode
death -i
Interactive Mode
In interactive mode, you can:
- View all running processes in a formatted table
- Kill processes by entering their PID
- Refresh the process list
- Navigate using arrow keys and enter
Commands and Flags
Command/Flag | Description |
---|---|
list | List all running processes |
-l, --list | List all running processes |
-k, --kill <pid> | Kill a process by PID |
-i, --interactive | Run in interactive mode |
-h, --help | Show help text |
-v, --version | Show version |
Project Structure
death/
āāā index.js # Entry point
āāā utils/
ā āāā cli.js # CLI interface and command handling
ā āāā processes.js # Process management functions
āāā package.json
Dependencies
chalk
- Terminal string stylinginquirer
- Interactive command line interfacecli-table3
- Pretty unicode tablesmeow
- CLI app helper
License
MIT
Author
Mitul Patel