DEV Community

pete
pete

Posted on

🧠 Double Header Drop: FileWatchAgent + MailmanAgent

β€œThe Swarm doesn't ask for uptime. It logs it.”


πŸ›°οΈ Operation: Double Header

We deployed two agents β€” one watches, the other writes history.


πŸ”§ 1. FileWatchAgent

  • πŸ‘οΈ Monitors: /etc/ (or any declared path)
  • 🧠 Reports: CREATE, MODIFY, DELETE, MOVE, ACCESS
  • πŸ“¦ Drops .json logs into MailmanAgent’s payload/
{
  "permanent_id": "filewatch-1",
  "name": "filewatch",
  "filesystem": {
    "folders": [ { "name": "payload", "type": "d" } ]
  },
  "config": {
    "watch_path": "/etc/",
    "send_to": "mailman-1"
  }
}
πŸ“¬ 2. MailmanAgent
🧾 Deduplicates by hash

πŸ“₯ Archives structured logs in mail/, tally/, and incoming/

πŸ“€ Feeds GUI + Telegram (if enabled)

json
Copy
Edit
{
  "permanent_id": "mailman-1",
  "name": "mailman",
  "filesystem": {
    "folders": [
      { "name": "payload", "type": "d" },
      { "name": "mail", "type": "d" },
      { "name": "tally", "type": "d" },
      { "name": "incoming", "type": "d" }
    ]
  }
}

πŸ§ͺ Test Results
βœ… Logs from FileWatch appear in /mail/ + /tally/

βœ… /incoming/ fills with .msg relays

βœ… GUI sees logs live

βœ… TelegramRelayAgent can forward instantly
Enter fullscreen mode Exit fullscreen mode

πŸ’₯ Kill Switch Added
Bootloader now supports this CLI:

bash
Copy
Edit
python3 bootloader.py --kill
Swarm-wide shutdown via Reaper.
Graceful if possible. Brutal if needed.

🧠 This is Swarm Ops
From one directive file, we spawn watchers, scribes, and reapers.
Every agent logs its life.
Every process is accountable.
Every heartbeat is visible.

And we built the whole thing in public.

πŸ”— Get Started
GitHub: https://github.com/matrixswarm/matrixswarm

Website: https://matrixswarm.com

YouTube: MatrixSwarm OS – Spawn, Kill, Resurrect

X/Twitter: @matrixswarm

πŸ“œ Fork It Clause
MatrixSwarm is open.
Fork it.
Or Fork U.
(The swarm is open. Bring tools or get logged.)

Top comments (0)