Hugging Face's logo

smlflg
/
agent-process-dashboard

Model card Files
xet
 Community
agent-process-dashboard / README.md
smlflg's picture
smlflg
Initial public upload from Projekte/agent-process-dashboard
06357e7 verified
preview code
|
Raw History Blame Contribute Delete
1.21 kB

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