MatrixSwarm
Automation that breathes. The Swarm that won’t die.
Not a Tool. A Digital Army.
- ✓ Agents repair, reboot, and protect themselves.
- ✓ No SaaS. No subscriptions. No downtime.
- ✓ You own it. You control it.
Your Swarm, Your Rules.
- ✓ Plug-and-play agents: add, upgrade, or kill jobs in seconds.
- ✓ True digital immortality—your swarm, your heartbeat, your rules.
Ready to Wake Your Swarm?
🚀 Download NowReplace SaaS fees and single-purpose scripts with one self-healing, agent-powered automation platform. No limits. No learning curve. Just automation—on your terms.

Explore the Swarm
Browse community-powered agents or contribute your own.
Agents
Monitoring
Log Watcher
`log_watcher` is a flexible and robust agent designed to monitor any specified log file in real-time. It tails the file, intelligently classifies new entries based on custom rules, and reports them to the swarm for analysis, making it a foundational sensor for system and application monitoring.
Security
Permissions Guardian
`permissions_guardian` is a mission-based agent responsible for enforcing file and directory permissions across designated paths. It detects discrepancies against a configured policy and optionally corrects them. Each run is single-pass and stateful, leaving behind a verifiable, encrypted change history.
Security
Tripwire Lite
The `tripwire_lite` agent acts as a real-time file integrity monitor. It uses the `inotify` library to watch specified directories and logs any changes, creations, or deletions that occur within them. This makes it an essential tool for security and for monitoring critical application code for unauthorized changes.
Monitoring
Nginx Watchdog
The `nginx_watchdog` is a service monitor that ensures the Nginx web server remains online and healthy.
Docs
Directives & The Hive
🎪 How Do You Cram a Swarm of Agents inside a Clown Car?
Step right up, children of the cloud! Ready for a carnival trick your ops team won’t believe? Imagine stuffing your entire AI automation swarm into a single, tamper-proof, encrypted artifact—no Docker, no plugins, no side files. Just one directive, and a circus of agents ready to roll anywhere, anytime... (Cue the calliope music)
Security Best Practices
How to Use the Directive Encryption Tool
Accreditation This guide was prepared in collaboration with Gemini, the swarm's designated AI construct for documentation and analysis. This guide explains how to use the matrixswarm-encrypt-directive tool to secure your boot directives. This tool encrypts an entire directive file, protecting sensitive information like API keys, private keys, and file integrity hashes before the swarm is even launched. Overview The primary function of this tool is to take a plaintext directive file (.py or .json) and output an encrypted version. Its key features include: AES-GCM Encryption: Encrypts the entire directive with a strong, authenticated encryption cipher. Automatic Key Generation: Can automatically generate secure RSA keypairs for agents directly within the directive, which is ideal for agents that need to decrypt messages from external sources. Future-Proof Security: This tool is the foundation for advanced security patterns, such as storing private keys for matrix_https and matrix_websocket to enable mutually authenticated communication, and for storing tripwire_lite file hashes to ensure the integrity of the swarm's core files.
Use Cases & Examples
How a Secure Message is Processed in MatrixSwarm
This guide explains the end-to-end encrypted journey of a message, from a visitor on your website to a notification for your team. This process ensures that a submitted message is never stored in plaintext on the web server, providing a high level of security. Overview Front-End: A standard PHP web application. Back-End: The Python-based MatrixSwarm. Encryption: Hybrid RSA + AES-GCM. Result: A secure, automated pipeline for handling external communications.
Getting Started
How to Install Your First Swarm Agent
MatrixSwarm isn’t a plugin. It’s not a daemon. It’s not trapped inside Docker. It’s a file-driven, resurrection-capable swarm OS that runs beside your system, not under it. This guide walks you through deploying your first Swarm universe, from zero to operational GUI, in 5 steps—no containers, no headaches.
News
Agent Spotlight
Why WordPress Needs the Swarm
WordPress is the world’s most popular platform—but also the most attacked, most broken, and most plugin-dependent. MatrixSwarm changes the game: you get true self-healing, hands-off automation, and total freedom from plugin ransom, SaaS lock-in, and late-night admin emergencies. If you want your site to run like a fortress—this is where you begin.