← Back to Skills Marketplace
brandonwise

Workspace Cleaner

by brandonwise · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
859
Downloads
0
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install workspace-cleaner
Description
Automates safe cleanup of OpenClaw workspaces by previewing and moving temp files, logs, duplicates, and cruft to the system trash with customizable filtering.
Usage Guidance
This skill appears to do what it says, but review before enabling automation: 1) Run a dry-run (no --execute) and inspect the JSON output to confirm targets. 2) Check config/patterns.json and references/safe-defaults.md to ensure your important files/dirs are in protected_files/protected_dirs. 3) Note the script defaults to $CLAWD_WORKSPACE or ~/clawd if you don't pass --workspace — set the workspace explicitly if different. 4) The script calls local git and trash utilities (git remote get-url, trash/trash-put); ensure these are present and behave as you expect. 5) Avoid copying the provided cron/pre-commit examples verbatim with --execute; test thoroughly before scheduling automatic deletes. 6) If you want stronger safety, add additional protected paths or require manual review before any automated run.
Capability Analysis
Type: OpenClaw Skill Name: workspace-cleaner Version: 1.0.0 The OpenClaw Workspace Cleaner skill is designed for safe local file system cleanup. The `scripts/cleanup.py` uses `subprocess.run` to execute `git` and `trash` commands, passing arguments as a list, which securely prevents shell injection. It defaults to a dry-run, moves files to system trash instead of permanent deletion, and explicitly protects critical OpenClaw directories and files (e.g., `memory/`, `.git/`, `MEMORY.md`). There is no evidence of data exfiltration, unauthorized network activity, persistence mechanisms, or malicious prompt injection attempts in `SKILL.md` or other documentation. The code aligns with its stated purpose and incorporates robust safety features.
Capability Assessment
Purpose & Capability
The name/description match the included script and config. The script finds temp files, images, node_modules, venvs, and duplicate repos (via local git remotes) and moves them to trash. Required tools (python, trash/trash-cli, git) align with its behavior.
Instruction Scope
SKILL.md instructs running the bundled script with preview/execute and documents configuration and patterns. Minor inconsistencies: the script will default the workspace to $CLAWD_WORKSPACE or ~/clawd if not provided, but SKILL.md does not document the CLAWD_WORKSPACE env var. Also SKILL.md includes examples (cron, pre-commit, HEARTBEAT) that, if used with --execute without review, could cause automated deletions — the behavior is expected but operators should be careful when wiring it into automated jobs.
Install Mechanism
There is no install spec — this is an instruction-only skill with a shipped Python script and config. Nothing is downloaded or installed by the registry entry itself.
Credentials
The skill declares no required credentials or env vars, and the script does not request secrets. It does read $CLAWD_WORKSPACE (undocumented in SKILL.md) to choose a default workspace and invokes local commands (git, trash). No network endpoints or external credentials are used.
Persistence & Privilege
always is false and the skill does not request persistent privileges or modify other skills. It can be invoked autonomously by the agent (default behavior) but that is expected for user-invocable tools and not inherently elevated.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install workspace-cleaner
  3. After installation, invoke the skill by name or use /workspace-cleaner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug workspace-cleaner
Version 1.0.0
License
All-time Installs 6
Active Installs 6
Total Versions 1
Frequently Asked Questions

What is Workspace Cleaner?

Automates safe cleanup of OpenClaw workspaces by previewing and moving temp files, logs, duplicates, and cruft to the system trash with customizable filtering. It is an AI Agent Skill for Claude Code / OpenClaw, with 859 downloads so far.

How do I install Workspace Cleaner?

Run "/install workspace-cleaner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Workspace Cleaner free?

Yes, Workspace Cleaner is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Workspace Cleaner support?

Workspace Cleaner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Workspace Cleaner?

It is built and maintained by brandonwise (@brandonwise); the current version is v1.0.0.

💬 Comments