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.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
nameprocess-watch
descriptionMonitor 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)