DEV Community

Daniel
Daniel

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)