Have you ever wanted to trigger real logic — a script, a webhook, a notification — when a file appears in a folder?

You could:

  • Write a daemon
  • Set up inotifywait or fswatch
  • Build a custom shell loop
  • Fight with permissions, sockets, or systemd

But here’s a quieter way:

🧠 MatrixSwarm: A File-Driven Agent System

With MatrixSwarm, you drop a single JSON into the system — and the OS creates an agent that:

  • Lives inside a folder
  • Watches any directory you want
  • Reacts to changes by design
  • Logs actions directly to the Codex

No containers. No runtime. No “always-on” loop.

Just file events + single-purpose Python.

📁 Example Agent: File Watcher 

{
  "agent_name": "watcher-1",
  "permanent_id": "watcher-1",
  "delegated": [],
  "filesystem": {
    "folders": [
      { "name": "payload", "type": "d", "content": null }
    ],
    "files": {}
  }
}

🔁 Real Use Cases
Upload folder monitor

GitHub Actions trigger

Discord file drop responder

Email inbox reader

Remote camera frame detector

🔗 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.)