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