Tidyfiles is a versatile command-line utility for recording, tracking, and auditing file organization tasks with built-in statistics and multi-format export capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tidyfiles
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tidyfiles using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Tidyfiles?
Tidyfiles serves as a specialized audit trail and management layer for developers and power users who need to maintain order within their local file systems. It functions as an offline-first toolkit that logs every organizational action—from sorting downloads to analyzing disk usage—into dedicated, pipe-delimited log files. By bridging the gap between manual file manipulation and automated reporting, it ensures every cleanup effort is documented and searchable.
As a prominent entry in the Openclaw Skills library, Tidyfiles prioritizes data sovereignty and simplicity. It operates entirely through pure bash scripts without external dependencies, making it an ideal companion for AI agents and developers who require a lightweight, transparent method to track file-system state changes and batch operations over time.
Tidyfiles Use Cases
- Tracking complex file organization tasks to maintain a historical audit trail.
- Auditing directory structure checks to ensure backup integrity and consistency.
- Logging disk usage analysis patterns for long-term storage planning.
- Documenting batch file operations such as bulk renaming or format conversions.
- Generating automated cleanup reports for stakeholders or personal productivity tracking.
How Tidyfiles Works
- The user executes a core command (e.g., run, check, analyze) followed by a descriptive string of the action performed.
- Tidyfiles captures the input and appends a YYYY-MM-DD HH:MM timestamp to a command-specific log file in the local share directory.
- Every transaction is simultaneously recorded in a unified history.log for a global view of all Openclaw Skills activities.
- Users can query the logs using built-in search or stats commands to visualize progress or disk usage trends.
- Data can be exported into JSON, CSV, or TXT formats for integration with external analysis tools or spreadsheets.
Tidyfiles Setup
To integrate Tidyfiles into your workflow, ensure you have Bash 4.0+ installed. Follow these steps to set up this component of Openclaw Skills:
# Clone or download the tidyfiles script
# Ensure the script is executable
chmod +x tidyfiles
# Move to your local bin for easy access
mv tidyfiles /usr/local/bin/
# Initialize the data directory
mkdir -p ~/.local/share/tidyfiles/
# Verify installation
tidyfiles status
Tidyfiles Data Schema & Taxonomy
Tidyfiles organizes data in a structured, flat-file hierarchy located at ~/.local/share/tidyfiles/. This transparent structure makes it easy for other Openclaw Skills to parse the data.
| File | Type | Description |
|---|---|---|
*.log |
Text (Pipe-Delimited) | Individual logs for commands like run.log, check.log, etc. Format: Timestamp|Input. |
history.log |
Text (Pipe-Delimited) | A master record of every action taken across all command types. |
export.* |
JSON/CSV/TXT | Periodic data snapshots generated for external reporting. |
Tidyfiles Advanced Features
- Multi-format data portability supporting JSON and CSV for data science workflows.
- Case-insensitive global search across the entire log ecosystem.
- Health check diagnostics via the status command to monitor disk impact and entry counts.
- Dual-mode command execution for both data entry and rapid retrieval of recent activity.
- Zero-dependency architecture ensuring maximum compatibility across Unix-like environments.
SKILL.md
Loading
Related Openclaw Skills
Lifegoals
A local-first, command-line toolkit for defining, linting, and tracking long-term life goals and milestones.
Slide Presentation Builder
A powerful CLI-driven presentation builder that turns structured data into professional slide decks and interactive HTML presentations.
PropertyGuru SG Sale Browser Crawl
A browser-based scraper that extracts comprehensive property for-sale listings from PropertyGuru Singapore using Playwright to bypass anti-bot protections.
PV_27 Island Watchman
A high-empathy AI defense skill designed for emotional support and resource maximization in challenging scenarios.
GitLog
GitLog is a local-first developer toolkit designed to manage, analyze, and report on git commit history and repository patterns through a simple CLI.
Base64 Developer Reference
A comprehensive reference tool for developers to quickly look up Base64 concepts, implementation patterns, and debugging strategies.
Featured*
