process-watch
Monitor system processes - CPU, memory, disk I/O, network, open files, ports. Find resource hogs, kill runaway processes, track what's consuming your machine.
When & Why to Use This Skill
Process Watch is a comprehensive system monitoring and management tool for Claude, designed to provide deep visibility into machine resources. It goes beyond basic process listing by tracking CPU, memory, disk I/O, network connections, and port bindings in real-time. This skill is essential for developers and system administrators who need to identify resource-heavy applications, debug network conflicts, and maintain optimal system performance through an intuitive conversational interface.
Use Cases
- Resource Optimization: Identify and terminate 'resource hogs' or runaway processes that are consuming excessive CPU or memory to improve system responsiveness.
- Network Debugging: Quickly find which process is listening on a specific port (e.g., port 3000) or monitor active network connections to troubleshoot connectivity issues.
- Proactive System Health: Use 'Watch Mode' to set custom alerts for CPU and memory thresholds, ensuring you are notified before the system reaches critical load levels.
- Deep Process Inspection: Audit process trees, open file handles, and environment variables to understand the behavior of specific applications or investigate security concerns.
| name | process-watch |
|---|---|
| description | Monitor system processes - CPU, memory, disk I/O, network, open files, ports. Find resource hogs, kill runaway processes, track what's consuming your machine. |
| emoji | "📊" |
| bins | ["python3"] |
Process Watch
Comprehensive system process monitoring. Goes beyond basic top to show:
- CPU & memory usage
- Disk I/O per process
- Network connections
- Open files & handles
- Port bindings
- Process trees
Commands
List processes
process-watch list [--sort cpu|mem|disk|name] [--limit 20]
Top resource consumers
process-watch top [--type cpu|mem|disk|net] [--limit 10]
Process details
process-watch info <pid>
# Shows: CPU, memory, open files, network connections, children, environment
Find by name
process-watch find <name>
# e.g., process-watch find chrome
Port bindings
process-watch ports [--port 3000]
# What's listening on which port?
Network connections
process-watch net [--pid <pid>] [--established]
Kill process
process-watch kill <pid> [--force]
process-watch kill --name "chrome" [--force]
Watch mode
process-watch watch [--interval 2] [--alert-cpu 80] [--alert-mem 90]
# Continuous monitoring with threshold alerts
System summary
process-watch summary
# Quick overview: load, memory, disk, top processes
Examples
# What's eating my CPU?
process-watch top --type cpu
# What's on port 3000?
process-watch ports --port 3000
# Details on a specific process
process-watch info 1234
# Kill all Chrome processes
process-watch kill --name chrome
# Watch with alerts
process-watch watch --alert-cpu 90 --alert-mem 85
Platform Support
- macOS: Full support
- Linux: Full support
- Windows: Partial (basic process list, no lsof equivalent)