🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Tidyfiles
πŸ¦€ ClawHub✦ BytesAgain

Tidyfiles

by @xueyetianya

Sort and organize files into folders by type, date, or rules. Use when decluttering dirs, checking structure, running cleanup, generating reports.

Versionv2.0.0
Downloads358
Installs1
#clawhub
TERMINAL
clawhub install tidyfiles

πŸ“– About This Skill

version: "2.0.0" name: tidyfiles description: "Sort and organize files into folders by type, date, or rules. Use when decluttering dirs, checking structure, running cleanup, generating reports."

Tidyfiles

A versatile utility toolkit for recording, tracking, and managing file organization tasks from the command line. Each command logs timestamped entries to its own dedicated log file, with built-in statistics, multi-format export, search, and health-check capabilities.

Why Tidyfiles?

  • Works entirely offline β€” your data stays on your machine
  • Each command type maintains its own log file for clean data separation
  • Built-in multi-format export (JSON, CSV, plain text)
  • Full activity history with timestamped audit trail
  • Search across all log files instantly
  • Summary statistics with entry counts and disk usage
  • Zero external dependencies β€” pure bash

    • Commands

    Core Operations

    | Command | Description | |---------|-------------| | tidyfiles run | Record a run entry (no args: show recent entries) | | tidyfiles check | Record a check entry (no args: show recent entries) | | tidyfiles convert | Record a convert entry (no args: show recent entries) | | tidyfiles analyze | Record an analyze entry (no args: show recent entries) | | tidyfiles generate | Record a generate entry (no args: show recent entries) | | tidyfiles preview | Record a preview entry (no args: show recent entries) | | tidyfiles batch | Record a batch entry (no args: show recent entries) | | tidyfiles compare | Record a compare entry (no args: show recent entries) | | tidyfiles export | Record an export entry (no args: show recent entries) | | tidyfiles config | Record a config entry (no args: show recent entries) | | tidyfiles status | Record a status entry (no args: show recent entries) | | tidyfiles report | Record a report entry (no args: show recent entries) |

    Utility Commands

    | Command | Description | |---------|-------------| | tidyfiles stats | Show summary statistics (entry counts per type, total, disk usage) | | tidyfiles export | Export all data in json, csv, or txt format | | tidyfiles search | Search across all log files (case-insensitive) | | tidyfiles recent | Show the 20 most recent activity log entries | | tidyfiles status | Health check (version, entries, disk, last activity) | | tidyfiles help | Display all available commands | | tidyfiles version | Print version string |

    Each core command works in two modes:

  • With arguments: Saves a timestamped entry to .log and logs to history.log
  • Without arguments: Displays the 20 most recent entries from that command's log

    • Data Storage

    All data is stored locally in ~/.local/share/tidyfiles/. The directory contains:

  • run.log, check.log, convert.log, analyze.log, etc. β€” One log file per command type, storing YYYY-MM-DD HH:MM|input entries
  • history.log β€” Unified activity log with timestamped records of every command executed
  • export.json / export.csv / export.txt β€” Generated export files

    • Requirements

  • Bash 4.0+ with set -euo pipefail strict mode
  • Standard Unix utilities: grep, cat, tail, wc, du, date, sed
  • No external dependencies or network access required

    • When to Use

    1. Tracking file organization tasks β€” Use tidyfiles run "sorted ~/Downloads by file type" to log cleanup activities with timestamps 2. Checking directory structure β€” Record structure checks with tidyfiles check "~/projects: 45 dirs, 230 files, no empty dirs" 3. Analyzing disk usage patterns β€” Log analysis results with tidyfiles analyze "Documents folder: 12GB, 40% PDFs" and review with tidyfiles search "Documents" 4. Batch file operations β€” Track batch processing with tidyfiles batch "renamed 150 photos with date prefix" and review past batches 5. Generating cleanup reports β€” Use tidyfiles report "weekly cleanup: freed 3.2GB" then tidyfiles export csv for spreadsheet analysis

    Examples

    # Record file organization activities
tidyfiles run "organized Downloads into subfolders"
tidyfiles check "verified backup integrity: 100% match"
tidyfiles analyze "home directory: 85GB used, 15GB free"
    Track conversions and batch operations
    
tidyfiles convert "batch converted 200 PNGs to WebP"
tidyfiles batch "moved archived projects to cold storage"
tidyfiles generate "created folder structure for new project"
    Preview and compare
    
tidyfiles preview "dry-run sort of ~/Desktop: 45 files to move"
tidyfiles compare "before/after cleanup: 12GB freed"
    Search, review, and export
    
tidyfiles search "backup"
tidyfiles recent
tidyfiles stats
tidyfiles export json
tidyfiles export csv
    Configuration and reporting
    
tidyfiles config "default sort: by extension"
tidyfiles report "monthly cleanup summary: 25GB reclaimed"
tidyfiles status

    Configuration

    The data directory defaults to ~/.local/share/tidyfiles/. All log files are plain text with pipe-delimited fields (timestamp|value), making them easy to parse with standard Unix tools or import into spreadsheets.

    Powered by BytesAgain | bytesagain.com | hello@bytesagain.com

    ⚑ When to Use

    TriggerAction
    2. **Checking directory structure** β€” Record structure checks with `tidyfiles check "~/projects: 45 dirs, 230 files, no empty dirs"`
    3. **Analyzing disk usage patterns** β€” Log analysis results with `tidyfiles analyze "Documents folder: 12GB, 40% PDFs"` and review with `tidyfiles search "Documents"`
    4. **Batch file operations** β€” Track batch processing with `tidyfiles batch "renamed 150 photos with date prefix"` and review past batches
    5. **Generating cleanup reports** β€” Use `tidyfiles report "weekly cleanup: freed 3.2GB"` then `tidyfiles export csv` for spreadsheet analysis

    πŸ’‘ Examples

    # Record file organization activities
tidyfiles run "organized Downloads into subfolders"
tidyfiles check "verified backup integrity: 100% match"
tidyfiles analyze "home directory: 85GB used, 15GB free"
    Track conversions and batch operations
    
tidyfiles convert "batch converted 200 PNGs to WebP"
tidyfiles batch "moved archived projects to cold storage"
tidyfiles generate "created folder structure for new project"
    Preview and compare
    
tidyfiles preview "dry-run sort of ~/Desktop: 45 files to move"
tidyfiles compare "before/after cleanup: 12GB freed"
    Search, review, and export
    
tidyfiles search "backup"
tidyfiles recent
tidyfiles stats
tidyfiles export json
tidyfiles export csv
    Configuration and reporting
    
tidyfiles config "default sort: by extension"
tidyfiles report "monthly cleanup summary: 25GB reclaimed"
tidyfiles status

    βš™οΈ Configuration

    The data directory defaults to ~/.local/share/tidyfiles/. All log files are plain text with pipe-delimited fields (timestamp|value), making them easy to parse with standard Unix tools or import into spreadsheets.

    Powered by BytesAgain | bytesagain.com | hello@bytesagain.com