proc-scan

# proc-scan

Scan running processes using system commands to gather CPU, memory, process tree, and runtime data. Analyze and identify top resource consumers, detect anomalies like zombies or runaway processes, and explain what each significant process does, how critical it is to system operation, and whether it can safely be killed.

## Installation

This is a CmdForge tool. Install it from the registry:

```bash
cmdforge install proc-scan
```

## Usage

Basic process scan and analysis:

```bash
echo "" | proc-scan
```

Scan with specific focus:

```bash
echo "Focus on high CPU consumers" | proc-scan
```

Target specific process investigation:

```bash
echo "Analyze all Chrome processes" | proc-scan
```

Check for system health issues:

```bash
echo "Look for zombie processes and memory leaks" | proc-scan
```

## Arguments

This tool has no additional arguments.

## How It Works

1. **gather_process_data** (code step): Executes system commands to collect comprehensive process information including CPU usage, memory consumption, process tree structure, and runtime statistics.

2. **analyze_processes** (prompt step): Sends the gathered process data to Claude Sonnet for intelligent analysis. Identifies top resource consumers, detects anomalies, explains the purpose of significant processes, assesses their criticality to system operation, and provides safety recommendations for process termination.

## Dependencies

None