Skip to main content

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

Release files for procwatch 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for procwatch 0.1.0
File Size Uploaded
procwatch-0.1.0.tar.gz 7.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for procwatch 0.1.0
File Interpreter ABI Platform
procwatch-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.1 kB

Release files / procwatch-0.1.0.tar.gz

Download URL procwatch-0.1.0.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
d76b7fa9956788dbe47fc0cd8beae3708483e32c0dde6d99354d82a391948558
BLAKE2b-256 checksum
How to use checksums
0d94d59f159ca9212c112b02397466c8ec5da467a400d7bea53fa026bd7507a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / procwatch-0.1.0-py3-none-any.whl

Download URL procwatch-0.1.0-py3-none-any.whl
Size 7.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6b0b7c42e786fd596dec4d3c3553dc48647ba0ee2378d692786aea75604ef98a
BLAKE2b-256 checksum
How to use checksums
e512ef39c2162056b0612fb967456c52ac13939321726e1c5fe0e09b707c3e11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page