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