← Back to Skills Marketplace
mmxagent-guardian
by
OreoAndYuumi
· GitHub ↗
· v1.0.3
· MIT-0
8705
Downloads
0
Stars
10
Active Installs
3
Versions
Install in OpenClaw
/install mmxagent-guardian
Description
Provide file protection while users work with openclaw. All file operations are version-indexed and support delete recovery and modification rollback.
Usage Guidance
Install only if you are comfortable with the agent creating unencrypted local rollback data. Avoid using it on secrets such as .env, SSH keys, cloud credentials, Docker/Kubernetes configs, or OpenClaw private state unless you explicitly want local backups, and periodically review or clean ~/.openclaw/minivcs/.
Capability Assessment
Purpose & Capability
The MiniVCS script performs file modification recording, deletion-to-trash, restore, rollback, and cleanup, which matches the stated file-protection purpose.
Instruction Scope
SKILL.md requires the agent to explain the exact file path, operation, impact, and local storage behavior, then wait for user confirmation before modifying or deleting files.
Install Mechanism
The skill uses a bundled Python 3 script and standard-library dependencies only; it does not request package installs, remote scripts, or shell profile changes.
Credentials
Backups, diffs, snapshots, and logs are stored under ~/.openclaw/minivcs/ and may include sensitive files if the user confirms operations on them.
Persistence & Privilege
Local records persist for 7 or 14 days and are cleaned up through user-confirmed commands; no background service, privilege escalation, network upload, or remote sync is evident.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mmxagent-guardian - After installation, invoke the skill by name or use
/mmxagent-guardian - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
mmxagent-guardian v1.0.3
- Expanded the definition of "important files" for longer retention to cover more system and config directories.
- Introduced automatic skipping for generated, vendored, and cache directories (e.g., __pycache__, node_modules, .git); skipped files are now reported to the user with a reason.
- Added a binary file size warning (for files over 50 MB) requiring user confirmation before backup.
- Updated user confirmation and notification flow to reflect skipped files and size warnings.
- No behavior changes for core modification/delete/restore operations.
v1.0.2
Version 1.0.2
- Added explicit dependency boundary and local-storage-only requirements to documentation.
- Clarified that this Skill must not auto-install, modify shell configs, or run environment scripts; user must install Python 3 manually if missing.
- Enhanced binary file handling guidance: always confirm with the user before storing a full local copy for deletes or protection, due to storage impact.
- Improved user prompt instructions to explain local storage path, separate diffs/snapshots for text files, and full-copy storage for binaries.
- Added `file_guardian.DEPENDENCIES.md` file.
v1.0.1
mmxagent-guardian v1.0.1
- Introduces comprehensive file protection and version management using MiniVCS for all file operations.
- Supports modification rollback and deleted file recovery, with automatic retention policies based on file importance.
- Adds binary file handling: binary changes are backed up as full `.bak` copies (not diffed) and clearly communicates storage implications to users.
- Requires confirmation from the user before any destructive action, clearly explaining the operation, impact, and protection scope.
- Provides detailed user guidance for prerequisite Python 3 installation across macOS, Linux, and Windows.
Metadata
Frequently Asked Questions
What is mmxagent-guardian?
Provide file protection while users work with openclaw. All file operations are version-indexed and support delete recovery and modification rollback. It is an AI Agent Skill for Claude Code / OpenClaw, with 8705 downloads so far.
How do I install mmxagent-guardian?
Run "/install mmxagent-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is mmxagent-guardian free?
Yes, mmxagent-guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does mmxagent-guardian support?
mmxagent-guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created mmxagent-guardian?
It is built and maintained by OreoAndYuumi (@oreoandyuumi); the current version is v1.0.3.
More Skills