This content originally appeared on DEV Community and was authored by Daniel MacDonald
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
orfswatch
- 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
json
{
"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
Fork it.
Or Fork U.
(The swarm is open. Bring tools or get logged.)
This content originally appeared on DEV Community and was authored by Daniel MacDonald

Daniel MacDonald | Sciencx (2025-04-20T00:18:16+00:00) Watch Any Folder. Spawn a Response. No Daemons. No Cron. Just Files.. Retrieved from https://www.scien.cx/2025/04/20/watch-any-folder-spawn-a-response-no-daemons-no-cron-just-files/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.