# Agent Process Dashboard

Standalone GTK dashboard for local Linux agent-process fanout.

The app is deliberately conservative:

- Reads `/proc` directly.
- Shows current-user process trees and agent/MCP bridge fanout.
- Reports stale and cleanup candidates as a dry-run only.
- Can send `SIGTERM` and, after a failed stop, `SIGKILL` only to current dry-run
  candidates after explicit confirmation and a fresh PID identity recheck.
- Does not restart, renice, mutate configs, read process environments, or open a
  network port.

Stopping a process can abort running agent/tool work. Forced kill cannot be
handled by the target process and can lose in-flight state.

## Run

```bash
cd /home/smlflg/Projekte/agent-process-dashboard
PYTHONPATH=src python3 -m agent_process_dashboard
```

## Snapshot Without GTK

```bash
PYTHONPATH=src python3 -m agent_process_dashboard --snapshot
PYTHONPATH=src python3 -m agent_process_dashboard --dry-run
```

## Test

```bash
cd /home/smlflg/Projekte/agent-process-dashboard
PYTHONPATH=src python3 -m pytest -q
```

## System Dependencies

The GTK app uses PyGObject/GTK3. On Ubuntu/Pop!_OS this usually means:

```bash
sudo apt-get install -y python3-gi gir1.2-gtk-3.0
```