{"skill":{"slug":"clawdbot-filesystem","displayName":"Filesystem Management","summary":"Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot","description":"---\nname: filesystem\ndescription: Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot\nhomepage: https://github.com/gtrusler/clawdbot-filesystem\nmetadata: {\"clawdbot\":{\"emoji\":\"📁\",\"requires\":{\"bins\":[\"node\"]}}}\n---\n\n# 📁 Filesystem Management\n\nAdvanced filesystem operations for AI agents. Comprehensive file and directory operations with intelligent filtering, searching, and batch processing capabilities.\n\n## Features\n\n### 📋 **Smart File Listing**\n- **Advanced Filtering** - Filter by file types, patterns, size, and date\n- **Recursive Traversal** - Deep directory scanning with depth control\n- **Rich Formatting** - Table, tree, and JSON output formats\n- **Sort Options** - By name, size, date, or type\n\n### 🔍 **Powerful Search**\n- **Pattern Matching** - Glob patterns and regex support\n- **Content Search** - Full-text search within files\n- **Multi-criteria** - Combine filename and content searches\n- **Context Display** - Show matching lines with context\n\n### 🔄 **Batch Operations**\n- **Safe Copying** - Pattern-based file copying with validation\n- **Dry Run Mode** - Preview operations before execution\n- **Progress Tracking** - Real-time operation progress\n- **Error Handling** - Graceful failure recovery\n\n### 🌳 **Directory Analysis**\n- **Tree Visualization** - ASCII tree structure display\n- **Statistics** - File counts, size distribution, type analysis\n- **Space Analysis** - Identify large files and directories\n- **Performance Metrics** - Operation timing and optimization\n\n## Quick Start\n\n```bash\n# List files with filtering\nfilesystem list --path ./src --recursive --filter \"*.js\"\n\n# Search for content\nfilesystem search --pattern \"TODO\" --path ./src --content\n\n# Batch copy with safety\nfilesystem copy --pattern \"*.log\" --to ./backup/ --dry-run\n\n# Show directory tree\nfilesystem tree --path ./ --depth 3\n\n# Analyze directory structure\nfilesystem analyze --path ./logs --stats\n```\n\n## Command Reference\n\n### `filesystem list`\nAdvanced file and directory listing with filtering options.\n\n**Options:**\n- `--path, -p <dir>` - Target directory (default: current)\n- `--recursive, -r` - Include subdirectories\n- `--filter, -f <pattern>` - Filter files by pattern\n- `--details, -d` - Show detailed information\n- `--sort, -s <field>` - Sort by name|size|date\n- `--format <type>` - Output format: table|json|list\n\n### `filesystem search`\nSearch files by name patterns or content.\n\n**Options:**\n- `--pattern <pattern>` - Search pattern (glob or regex)\n- `--path, -p <dir>` - Search directory\n- `--content, -c` - Search file contents\n- `--context <lines>` - Show context lines\n- `--include <pattern>` - Include file patterns\n- `--exclude <pattern>` - Exclude file patterns\n\n### `filesystem copy`\nBatch copy files with pattern matching and safety checks.\n\n**Options:**\n- `--pattern <glob>` - Source file pattern\n- `--to <dir>` - Destination directory\n- `--dry-run` - Preview without executing\n- `--overwrite` - Allow file overwrites\n- `--preserve` - Preserve timestamps and permissions\n\n### `filesystem tree`\nDisplay directory structure as a tree.\n\n**Options:**\n- `--path, -p <dir>` - Root directory\n- `--depth, -d <num>` - Maximum depth\n- `--dirs-only` - Show directories only\n- `--size` - Include file sizes\n- `--no-color` - Disable colored output\n\n### `filesystem analyze`\nAnalyze directory structure and generate statistics.\n\n**Options:**\n- `--path, -p <dir>` - Target directory\n- `--stats` - Show detailed statistics\n- `--types` - Analyze file types\n- `--sizes` - Show size distribution\n- `--largest <num>` - Show N largest files\n\n## Installation\n\n```bash\n# Clone or install the skill\ncd ~/.clawdbot/skills\ngit clone <filesystem-skill-repo>\n\n# Or install via ClawdHub\nclawdhub install filesystem\n\n# Make executable\nchmod +x filesystem/filesystem\n```\n\n## Configuration\n\nCustomize behavior via `config.json`:\n\n```json\n{\n  \"defaultPath\": \"./\",\n  \"maxDepth\": 10,\n  \"defaultFilters\": [\"*\"],\n  \"excludePatterns\": [\"node_modules\", \".git\", \".DS_Store\"],\n  \"outputFormat\": \"table\",\n  \"dateFormat\": \"YYYY-MM-DD HH:mm:ss\",\n  \"sizeFormat\": \"human\",\n  \"colorOutput\": true\n}\n```\n\n## Examples\n\n### Development Workflow\n```bash\n# Find all JavaScript files in src\nfilesystem list --path ./src --recursive --filter \"*.js\" --details\n\n# Search for TODO comments\nfilesystem search --pattern \"TODO|FIXME\" --path ./src --content --context 2\n\n# Copy all logs to backup\nfilesystem copy --pattern \"*.log\" --to ./backup/logs/ --preserve\n\n# Analyze project structure\nfilesystem tree --path ./ --depth 2 --size\n```\n\n### System Administration\n```bash\n# Find large files\nfilesystem analyze --path /var/log --sizes --largest 10\n\n# List recent files\nfilesystem list --path /tmp --sort date --details\n\n# Clean old temp files\nfilesystem list --path /tmp --filter \"*.tmp\" --older-than 7d\n```\n\n## Safety Features\n\n- **Path Validation** - Prevents directory traversal attacks\n- **Permission Checks** - Verifies read/write access before operations\n- **Dry Run Mode** - Preview destructive operations\n- **Backup Prompts** - Suggests backups before overwrites\n- **Error Recovery** - Graceful handling of permission errors\n\n## Integration\n\nWorks seamlessly with other Clawdbot tools:\n- **Security Skill** - Validates all filesystem operations\n- **Git Operations** - Respects .gitignore patterns\n- **Backup Tools** - Integrates with backup workflows\n- **Log Analysis** - Perfect for log file management\n\n## Updates & Community\n\n**Stay informed about the latest Clawdbot skills and filesystem tools:**\n\n- 🐦 **Follow [@LexpertAI](https://x.com/LexpertAI)** on X for skill updates and releases\n- 🛠️ **New filesystem features** and enhancements\n- 📋 **Best practices** for file management automation\n- 💡 **Tips and tricks** for productivity workflows\n\nGet early access to new skills and improvements by following @LexpertAI for:\n- **Skill announcements** and new releases\n- **Performance optimizations** and feature updates  \n- **Integration examples** and workflow automation\n- **Community discussions** on productivity tools\n\n## License\n\nMIT License - Free for personal and commercial use.\n\n---\n\n**Remember**: Great filesystem management starts with the right tools. This skill provides comprehensive operations while maintaining safety and performance.","tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":22036,"installsAllTime":287,"installsCurrent":286,"stars":76,"versions":2},"createdAt":1769481215958,"updatedAt":1778485857338},"latestVersion":{"version":"1.0.2","createdAt":1769481608074,"changelog":"Clean naming: Removed 'Clawdbot' from display name, fixed LICENSE.md extension","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"gtrusler","userId":"s1741m03rkxbbym0p7r1fzqypx884ms6","displayName":"gtrusler","image":"https://avatars.githubusercontent.com/u/63480023?v=4"},"moderation":null}