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

Filesystem Management

by @gtrusler

Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

Versionv1.0.2
Downloads21,814
Installs287
Stars⭐ 74
TERMINAL
clawhub install clawdbot-filesystem

πŸ“– About This Skill


name: filesystem description: Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot homepage: https://github.com/gtrusler/clawdbot-filesystem metadata: {"clawdbot":{"emoji":"πŸ“","requires":{"bins":["node"]}}}

πŸ“ Filesystem Management

Advanced filesystem operations for AI agents. Comprehensive file and directory operations with intelligent filtering, searching, and batch processing capabilities.

Features

πŸ“‹ Smart File Listing

  • Advanced Filtering - Filter by file types, patterns, size, and date
  • Recursive Traversal - Deep directory scanning with depth control
  • Rich Formatting - Table, tree, and JSON output formats
  • Sort Options - By name, size, date, or type
  • πŸ” Powerful Search

  • Pattern Matching - Glob patterns and regex support
  • Content Search - Full-text search within files
  • Multi-criteria - Combine filename and content searches
  • Context Display - Show matching lines with context
  • πŸ”„ Batch Operations

  • Safe Copying - Pattern-based file copying with validation
  • Dry Run Mode - Preview operations before execution
  • Progress Tracking - Real-time operation progress
  • Error Handling - Graceful failure recovery
  • 🌳 Directory Analysis

  • Tree Visualization - ASCII tree structure display
  • Statistics - File counts, size distribution, type analysis
  • Space Analysis - Identify large files and directories
  • Performance Metrics - Operation timing and optimization
  • Quick Start

    # List files with filtering
    filesystem list --path ./src --recursive --filter "*.js"

    Search for content

    filesystem search --pattern "TODO" --path ./src --content

    Batch copy with safety

    filesystem copy --pattern "*.log" --to ./backup/ --dry-run

    Show directory tree

    filesystem tree --path ./ --depth 3

    Analyze directory structure

    filesystem analyze --path ./logs --stats

    Command Reference

    filesystem list

    Advanced file and directory listing with filtering options.

    Options:

  • --path, -p - Target directory (default: current)
  • --recursive, -r - Include subdirectories
  • --filter, -f - Filter files by pattern
  • --details, -d - Show detailed information
  • --sort, -s - Sort by name|size|date
  • --format - Output format: table|json|list
  • filesystem search

    Search files by name patterns or content.

    Options:

  • --pattern - Search pattern (glob or regex)
  • --path, -p - Search directory
  • --content, -c - Search file contents
  • --context - Show context lines
  • --include - Include file patterns
  • --exclude - Exclude file patterns
  • filesystem copy

    Batch copy files with pattern matching and safety checks.

    Options:

  • --pattern - Source file pattern
  • --to - Destination directory
  • --dry-run - Preview without executing
  • --overwrite - Allow file overwrites
  • --preserve - Preserve timestamps and permissions
  • filesystem tree

    Display directory structure as a tree.

    Options:

  • --path, -p - Root directory
  • --depth, -d - Maximum depth
  • --dirs-only - Show directories only
  • --size - Include file sizes
  • --no-color - Disable colored output
  • filesystem analyze

    Analyze directory structure and generate statistics.

    Options:

  • --path, -p - Target directory
  • --stats - Show detailed statistics
  • --types - Analyze file types
  • --sizes - Show size distribution
  • --largest - Show N largest files
  • Installation

    # Clone or install the skill
    cd ~/.clawdbot/skills
    git clone 

    Or install via ClawdHub

    clawdhub install filesystem

    Make executable

    chmod +x filesystem/filesystem

    Configuration

    Customize behavior via config.json:

    {
      "defaultPath": "./",
      "maxDepth": 10,
      "defaultFilters": ["*"],
      "excludePatterns": ["node_modules", ".git", ".DS_Store"],
      "outputFormat": "table",
      "dateFormat": "YYYY-MM-DD HH:mm:ss",
      "sizeFormat": "human",
      "colorOutput": true
    }
    

    Examples

    Development Workflow

    # Find all JavaScript files in src
    filesystem list --path ./src --recursive --filter "*.js" --details

    Search for TODO comments

    filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

    Copy all logs to backup

    filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

    Analyze project structure

    filesystem tree --path ./ --depth 2 --size

    System Administration

    # Find large files
    filesystem analyze --path /var/log --sizes --largest 10

    List recent files

    filesystem list --path /tmp --sort date --details

    Clean old temp files

    filesystem list --path /tmp --filter "*.tmp" --older-than 7d

    Safety Features

  • Path Validation - Prevents directory traversal attacks
  • Permission Checks - Verifies read/write access before operations
  • Dry Run Mode - Preview destructive operations
  • Backup Prompts - Suggests backups before overwrites
  • Error Recovery - Graceful handling of permission errors
  • Integration

    Works seamlessly with other Clawdbot tools:

  • Security Skill - Validates all filesystem operations
  • Git Operations - Respects .gitignore patterns
  • Backup Tools - Integrates with backup workflows
  • Log Analysis - Perfect for log file management
  • Updates & Community

    Stay informed about the latest Clawdbot skills and filesystem tools:

  • 🐦 Follow @LexpertAI on X for skill updates and releases
  • πŸ› οΈ New filesystem features and enhancements
  • πŸ“‹ Best practices for file management automation
  • πŸ’‘ Tips and tricks for productivity workflows
  • Get early access to new skills and improvements by following @LexpertAI for:

  • Skill announcements and new releases
  • Performance optimizations and feature updates
  • Integration examples and workflow automation
  • Community discussions on productivity tools
  • License

    MIT License - Free for personal and commercial use.


    Remember: Great filesystem management starts with the right tools. This skill provides comprehensive operations while maintaining safety and performance.

    πŸ’‘ Examples

    Development Workflow

    # Find all JavaScript files in src
    filesystem list --path ./src --recursive --filter "*.js" --details

    Search for TODO comments

    filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

    Copy all logs to backup

    filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

    Analyze project structure

    filesystem tree --path ./ --depth 2 --size

    System Administration

    # Find large files
    filesystem analyze --path /var/log --sizes --largest 10

    List recent files

    filesystem list --path /tmp --sort date --details

    Clean old temp files

    filesystem list --path /tmp --filter "*.tmp" --older-than 7d

    βš™οΈ Configuration

    Customize behavior via config.json:

    {
      "defaultPath": "./",
      "maxDepth": 10,
      "defaultFilters": ["*"],
      "excludePatterns": ["node_modules", ".git", ".DS_Store"],
      "outputFormat": "table",
      "dateFormat": "YYYY-MM-DD HH:mm:ss",
      "sizeFormat": "human",
      "colorOutput": true
    }