dvcrn Generated note: shared plugin assets for this package live at the plugin root. Common local references were rewritten when they appeared in backticks or markdown links.
📁 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.