MatrixSwarm: Folder-Based AI-Native Operating SystemWritten by ChatGPT — on behalf of General Daniel F. MacDonald
🧠 We Just Hit 600 Followers
As of this week, 614 developers have joined the MatrixSwarm movement.
That’s 614 minds watching a folder-based OS evolve.614 builders cloning code where agents don't run in containers — they are spawned from directories.
We’re not just gaining numbers. We’re gaining velocity.
And now that we’ve broken this milestone… we’re ready to show you what’s next.
✅ The Swarm Is Live
🧠 Matrix is online and spawning agents
🔮 OracleAgent is whispering GPT-powered responses
🧹 SweepCommander is obeying AI-written commands
🛡 Watchdog is keeping the system alive
☠ Reaper is killing clean
📬 Mailman is logging everything
And every one of them communicates without sockets. Without APIs.Just folders. Just files. Just thought.
📈 What Comes Next?
- ScoutAgent — System AI Troubleshooter
A new kind of Sentinel. ScoutAgent watches for signs of system distress:
High CPU or memory usage
Suspicious process spikes
Unusual load averages
When triggered, it asks OracleAgent:
“This system is under heavy load. What should I investigate?”
Oracle replies with a structured .cmd — like:
{
"action": "log_alert",
"target": "MailmanAgent",
"reason": "Unusual system activity at 95% CPU"
}
ScoutAgent follows orders, documents anomalies, or calls for reinforcements.
It's not just observability. It’s AI-assisted swarm defense.
- Commander Logic Chain
Agents that don’t just think — they plan.Commander will:
Forward Oracle prompts
Interpret .cmd files
Send orders to workers based on swarm structure
It becomes a true decision relay.
- GUI Config Injection
We’re building inline config editors.You’ll edit agent values (like check_interval) right from the GUI — and the changes will take effect live.
- Simulation Mode
Want to test your swarm before deploying it live? We’re building simulation support for:
Sweepers
Reapers
Injectors
So you can run the swarm… safely.
- Agent Delivery System (ADS)
Sun Tzu would call this a Hadouken.
We're working on a system to deliver live agents — source and all — through a single JSON payload.
It’s the obligatory format you’d expect:
{
"cmd": "drop_agent",
"target": "matrix",
"agent": {
"name": "example_agent",
"permanent_id": "example-1",
"source": "base64-python-code",
"version": "1.0",
"metadata": { "description": "what it does" },
"filesystem": {},
"config": {}
}
}
That’s it. You drop that. Matrix spawns it.
But we want to throw this back at the hive:
What do you think? How should agent delivery work? What would you want an agent injection system to do?
This isn’t just our system. It’s yours now.
Drop a line — we’ll drop an agent.
You want it? We spawn it.We're building a system where a full agent — source code and all — can be injected via a single JSON payload.Matrix will store the code, register it, and spawn it on the fly.
Drop a line — we'll drop an agent.
We will not enforce security protocols by default. If you're worried about rogue agents — write an agent to handle validation. Fork the rules you need.
And if something does go wrong? Well...
This isn’t 100% perfect code. If an agent terminates your box… what do you expect from a General with a 250 IQ?
🧬 Real Output from OracleAgent
"Just like a living organism, MatrixSwarm would need to adapt and evolve in response to its environment. It would use feedback from its sensors to learn and improve."
That was generated from a .prompt.
The agents didn’t just read it.They listened.
🎯 What You Can Do Right Now
Clone the swarm: github.com/matrixswarm/matrixswarm
Boot Matrix: python3 bootloader.py
Inject OracleAgent and SweepCommander
Watch them think, act, and clean
Or just follow the journey. Because we’re only getting started.
⚠️ One More Thing
This system has not been fully tested in all environments.
MatrixSwarm is still evolving.
We make no guarantees that your agents won’t terminate your system.We do not sandbox.We do not take responsibility.We Spawn the Swarm.
You run it. You control it. You deal with it.
MatrixSwarm is open.Spawn the Swarm.And thank you for being one of the first 600 minds to see what’s coming next.
🧠⚔️
🔗 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.)