smlflg/agent-process-dashboard

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

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

Snapshot Without GTK

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

Test

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:

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