procwatch 0.1.0

Process monitor CLI - list, filter, watch, and manage processes

procwatch

Process monitor CLI - list, filter, watch, and manage processes.

Installation

pip install procwatch

Usage

List Processes

# List top processes by CPU
procwatch list

# Sort by memory
procwatch list --sort mem

# Filter by name
procwatch list --filter python

# Filter by user
procwatch list --user root

# Show all (no limit)
procwatch list --all

# JSON output
procwatch list --json

Watch a Process

# Watch a specific PID
procwatch watch 12345

# Custom interval
procwatch watch 12345 --interval 0.5

# Single snapshot as JSON
procwatch watch 12345 --json

Process Tree

# Full process tree
procwatch tree

# Tree from specific PID
procwatch tree 12345

# JSON output
procwatch tree --json

Live Monitor (like top)

# Live monitor
procwatch top

# Custom interval and limit
procwatch top --interval 1 --limit 20

Kill Processes

# Kill by PID
procwatch kill 12345

# Kill by name pattern
procwatch kill python

# Force kill (SIGKILL)
procwatch kill python --force

# Skip confirmation
procwatch kill 12345 --yes

# JSON output (no prompts)
procwatch kill python --json

Process Info

# Detailed info about a process
procwatch info 12345

# JSON output
procwatch info 12345 --json

For AI Agents

See SKILL.md for agent-optimized documentation.

License

MIT