120 Lines That Know Your System Better Than You Do: Meet LoadRangeAgent

Written by General Loadrange

In a world full of bloated dashboards and noisy graphs, sometimes all you need is one sharp little agent with a mouth like a log printer and a brain like a profiler.

Introducing LoadRangeAgent — a 120-line Python sentinel that quietly watches your system's load behavior, logs meaningful patterns, writes a daily mission report, and tracks the top CPU abusers without flinching.

What She Does

Monitors 1-minute load averages, normalized to your CPU count
Tracks how long your system operates within each load range:
- <0.1, 0.1–0.5, 0.5–1.0, 1.0–2.0, >2.0
Breaks down load by hour, so you know when the pressure's on
Shows delta shifts per sample — not just raw values
Logs beautifully, and writes a JSON summary every night at midnight
Names the top 3 CPU-hogging processes by cumulative usage

Sample Log Output

[LOAD-AGENT] 2025-06-05 14:00:00 | --- Load Range Report ---
[LOAD-AGENT] 2025-06-05 14:00:00 | Load <0.1: 62.50% (+1.20%)
[LOAD-AGENT] 2025-06-05 14:00:00 | Load 1.0-2.0: 15.00% (-0.80%)
[LOAD-AGENT] 2025-06-05 14:00:00 | 13:00 load share: 42.30%
[LOAD-AGENT] 2025-06-05 14:00:00 | Top process: python (CPU Total: 38.40%)
[LOAD-AGENT] 2025-06-05 14:00:00 | --------------------------

yaml
Copy
Edit

Daily JSON Summary (Written Automatically)

At the end of each day (or on exit), the agent drops a summary file:

{
  "date": "2025-06-05",
  "load_distribution": {
    "<0.1": 56.7,
    "0.1-0.5": 22.3,
    "1.0-2.0": 7.4
  },
  "hourly_load_contribution": {
    "00:00": 6.2,
    "01:00": 5.8,
    "14:00": 28.1
  },
  "top_processes": [
    {
      "name": "python",
      "cpu_total": 34.6
    }
  ]
}
You can configure the output path — it defaults to /tmp/load_range_summary.json.

Why This Agent Matters
Zero dependencies beyond psutil

No setup — just run it

Lightweight enough to embed in cronjobs or swarm reflexes

Logs only what matters

Designed to be understood at a glance

How To Run
bash
Copy
Edit
pip install psutil
python load_range_agent.py
Let her run. Ctrl+C to stop — and she’ll dump her final report before exiting.

Coming Soon...
This is just recon. Next up:

CryptoAlertAgent: watches live price feeds and triggers reflexes

ApacheSentinel: built-in swarm watchdog with autorestart, cooldowns, and alerting

Then we're building BreakfastDaemon — system health in breakfast metaphors. Stay tuned.

Final Thoughts
She's lean.
She logs like a war reporter.
She knows where your load came from, when it hit, and who started it.

Give her a spin — and find out what your system's really been doing while you weren’t watching.

“Small script. Big mouth.” — General Loadrange

🔗 Follow the Swarm
GitHub: github.com/matrixswarm/matrixswarm

Dev.to: @matrixswarm

Discord: MatrixSwarm Agent

Codex Entry: “The Swarm Speaks”

X/Twitter: @matrixswarm

📜 Fork It Clause
MatrixSwarm is open.
Fork it.
Or Fork U.
(The swarm is open. Bring tools or get logged.)

pete @matrixswarm