← Back to Skills Marketplace
mmxagent-guardian
by
OreoAndYuumi
· GitHub ↗
· v1.0.3
· MIT-0
9432
Downloads
0
Stars
0
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 an agent-maintained local backup store that can retain sensitive files. Avoid using it on credential directories, .env files, cloud profiles, SSH/GPG keys, or system paths unless you explicitly intend that, and keep operations limited to trusted project files.
Capability Assessment
Credentials
Local storage under ~/.openclaw/minivcs is disclosed and there is no remote sync, but backups, diffs, snapshots, and logs are plaintext and may include credential material.
Install Mechanism
The skill uses a bundled Python script and standard-library dependencies only; the referenced curl|bash text is a prohibition, not an install instruction.
Instruction Scope
The instructions require user confirmation before modify/delete operations, but the implementation accepts arbitrary accessible paths and does not enforce project-root containment.
Persistence & Privilege
There is no cron, service, shell-profile modification, or privilege escalation, but recovery artifacts persist for 7 or 14 days and can include sensitive files copied from outside the workspace.
Purpose & Capability
Versioning, trash, and rollback fit the stated file-protection purpose, but the artifact explicitly includes system paths, credential directories, and .env/config files in its protection scope.
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 9432 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