📁 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 <dir>

  - Target directory (default: current)

• --recursive, -r

  - Include subdirectories

• --filter, -f <pattern>

  - Filter files by pattern

• --details, -d

  - Show detailed information

• --sort, -s <field>

  - Sort by name|size|date

• --format <type>

  - Output format: table|json|list

filesystem search

Search files by name patterns or content.

Options:

• --pattern <pattern>

  - Search pattern (glob or regex)

• --path, -p <dir>

  - Search directory

• --content, -c

  - Search file contents

• --context <lines>

  - Show context lines

• --include <pattern>

  - Include file patterns

• --exclude <pattern>

  - Exclude file patterns

filesystem copy

Batch copy files with pattern matching and safety checks.

Options:

• --pattern <glob>

  - Source file pattern

• --to <dir>

  - 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 <dir>

  - Root directory

• --depth, -d <num>

  - 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 <dir>

  - Target directory

• --stats

  - Show detailed statistics

• --types

  - Analyze file types

• --sizes

  - Show size distribution

• --largest <num>

  - Show N largest files

Installation

# Clone or install the skill
cd ~/.clawdbot/skills
git clone <filesystem-skill-repo>

# 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.