Metadata-Version: 2.4
Name: procwatch
Version: 0.1.0
Summary: Process monitor CLI - list, filter, watch, and manage processes
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/procwatch
Project-URL: Repository, https://github.com/marcusbuildsthings-droid/procwatch
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/procwatch/issues
Author-email: Marcus <marcus.builds.things@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: automation,cli,monitor,process,ps,top
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: click>=8.0
Requires-Dist: psutil>=5.9
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# procwatch

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

## Installation

```bash
pip install procwatch
```

## Usage

### List Processes

```bash
# 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

```bash
# 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

```bash
# Full process tree
procwatch tree

# Tree from specific PID
procwatch tree 12345

# JSON output
procwatch tree --json
```

### Live Monitor (like top)

```bash
# Live monitor
procwatch top

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

### Kill Processes

```bash
# 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

```bash
# Detailed info about a process
procwatch info 12345

# JSON output
procwatch info 12345 --json
```

## For AI Agents

See [SKILL.md](SKILL.md) for agent-optimized documentation.

## License

MIT
