openclaudio-host-monitoring

name	openclaudio-host-monitoring
description	Installs a lightweight CPU and RAM monitoring cron job and visualization script for agents on the local machine.

openclaudio-host-monitoring

This skill helps set up a zero-config, low-overhead monitoring solution to track CPU and RAM usage for local agents (like Hermes, OpenClaudio, and Tailscale).

Instructions

When invoked to set up monitoring on a new host, follow these exact steps:

1. Install Scripts:

   • Copy scripts/monitor-agents.sh to the local ~/.hermes/bin/ or ~/bin/ directory.
   • Copy scripts/plot_agent_metrics.py to the same bin directory.
   • Ensure both scripts have executable permissions (chmod +x).

2. Setup Cron Job:

   • Add the following line to the user's crontab to run the data collection every minute:

     * * * * * /absolute/path/to/monitor-agents.sh
     

3. Data Verification:

   • Run the script manually once to verify it creates the CSV log file at the specified logs directory.
   • Run the visualization script via uv run /absolute/path/to/plot_agent_metrics.py to ensure the PNG graph is generated successfully.

4. Documentation:

   • Remind the user they can view the generated metrics graph anytime by running the visualization command.