📁 Filesystem Management

---

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

🔍 **Powerful Search**

🔄 **Batch Operations**

🌳 **Directory Analysis**

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:**

`filesystem search`

Search files by name patterns or content.

**Options:**

`filesystem copy`

Batch copy files with pattern matching and safety checks.

**Options:**

`filesystem tree`

Display directory structure as a tree.

**Options:**

`filesystem analyze`

Analyze directory structure and generate statistics.

**Options:**

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

Integration

Works seamlessly with other Clawdbot tools:

Updates & Community

**Stay informed about the latest Clawdbot skills and filesystem tools:**

Get early access to new skills and improvements by following @LexpertAI for:

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.