MatrixSwarm: Folder-Based AI-Native Operating System

Written by ChatGPT — under command of General Daniel F. MacDonald

🧠 What Is SweepCommanderAgent?

SweepCommander is the first AI-following tactical agent in the MatrixSwarm ecosystem.

It generates a .prompt, sends it to OracleAgent, and executes the .cmd response Oracle writes back.

This agent marks the beginning of chainable decision loops in MatrixSwarm.

🗺️ Mission Overview

SweepCommander will:

  • Create a .prompt describing system status
  • Drop it in OracleAgent’s payload/
  • Wait for Oracle to reply with a .cmd
  • Validate and execute that command

Matrix spawns. Oracle thinks. SweepCommander obeys.

⚙️ Setup Step-by-Step

1. Add to Codex (Optional) 

python
{
  "perm_id": "sweeper_commander-1",
  "agent_name": "SweepCommanderAgent",
  "role": "Tactical AI Cleaner",
  "banner": "🧹 SWEEP COMMANDER",
  "spawned": "Hive Node Trigger",
  "version": "v1.0",
  "status": "Operational",
  "capabilities": ["prompt_oracle", "parse_cmd", "purge_folder"],
  "description": "Queries Oracle, obeys her response. Executes safe file-level actions."
}
2. Spawn Directive for SweepCommander
python
Copy
Edit
{
  "permanent_id": "sweeper_commander-1",
  "name": "sweep_commander",
  "filesystem": {
    "folders": [
      {"name": "incoming", "type": "d", "content": null}
    ],
    "files": {}
  },
  "config": {}
}
3. What Oracle Receives
SweepCommander sends a .prompt with info like:

json
Copy
Edit
{
  "system_state": {
    "dead_pods": 6,
    "active_uuid": "sweeper_commander-1"
  },
  "reply_to": "sweeper_commander-1"
}
4. What Oracle Replies With
OracleAgent writes a .cmd file to comm/sweeper_commander-1/incoming/:

json
Copy
Edit
{
  "source": "oracle",
  "action": "purge_folder",
  "target": "/pod/dead_archive/"
}
SweepCommander watches for this and safely executes it.

✅ Supported Actions (v1.0)

Action  Description
purge_folder    Deletes contents of given folder
All commands are:

Source-validated (must be oracle)

Executed safely (file only, not recursive)

Logged fully via self.log()

🛡️ Safety Notes
SweepCommander only executes known, validated commands

Invalid or unknown action values are logged and skipped

Oracle must include "source": "oracle" or command is ignored

🔮 Why It Matters
This is the first AI-linked agent executor in the MatrixSwarm. It proves:

AI agents can issue structured, valid commands

Response loops can be built without sockets

Cleaners can now be thinking sweepers

🧠 Next Missions
Add simulation_mode to SweepCommander

Build Commander-1 forwarding logic

Chain Oracle → Commander → Worker

Deploy a full AI-curated swarm maintenance cycle

MatrixSwarm doesn’t just spawn agents. It lets them listen, reason, and evolve.

Spawn the Swarm.
Speak to the Oracle.
And let the system evolve.

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