Filesystem Management

Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

Security Scan

The skill's stated purpose (filesystem operations) is plausible, but the package/installation details and the runtime instructions conflict (missing executable, undeclared network/install requirements), so proceed with caution and verify the code before installing.

Purpose & Capability

The name/description match the requested capabilities (listing, searching, batch ops). However package.json and SKILL.md imply a Node-based CLI named 'filesystem' that would be installed/run, yet no 'filesystem' binary/script is included in the published files. Also the documentation instructs cloning from GitHub and npm operations (network activity), but the skill metadata and package.json claim no network permission and only require 'node' (they do not list 'git' or 'npm' as required). These inconsistencies mean the manifest does not reliably represent what will be needed or executed.

Instruction Scope

The SKILL.md instructs the agent/user to clone a remote repo, make an executable 'filesystem', and run commands that access arbitrary paths (including examples touching /var/log, /etc). Those actions are expected for a filesystem tool, but the instructions require network access and local execution of a binary that is not present in the skill bundle. There is no instruction to validate the cloned code beyond simple chmod, so following the instructions blindly could run unreviewed code locally.

Install Mechanism

There is no formal install spec in the registry entry (instruction-only). The SKILL.md suggests 'git clone' and optional 'npm install -g .', which pulls code from a remote GitHub repo at runtime. Since no binary or install archive is bundled, the only way to obtain the runnable program is to fetch remote code. The registry metadata claims 'network: none' while the README/installation explicitly require network access — this mismatch raises risk because the actual install is a network fetch of code that will be executed locally.

Credentials

The skill does not request environment variables or credentials, and the declared primary credential is none — that is proportionate for a local filesystem tool. However, package.json lists 'network': 'none' in 'clawdbot.permissions' despite installation and README requiring network access (git/npm). Also the package.json permissions claim filesystem read-write, which is expected for this functionality but underscores the risk: this skill (if installed/executed) will be able to read and copy files on the host.

Persistence & Privilege

The skill does not set always:true and does not request persistent elevated registry privileges. It is user-invocable and allows autonomous model invocation (the platform default). There is no evidence the skill attempts to modify other skills or system-wide agent settings in the provided files.

What to consider before installing

This skill claims to be a CLI filesystem tool but the published package lacks the actual 'filesystem' executable referenced throughout the docs; the README and SKILL.md instruct you to git clone and run npm commands (network fetch) even though the manifest does not declare network or git/npm requirements. Before installing or running anything: 1) Inspect the remote repository (https://github.com/gtrusler/clawdbot-filesystem) yourself and verify the 'filesystem' script contents and authorship; 2) Do not run any cloned code as root — test in a sandbox/VM or container; 3) Confirm config.json protectedPaths and safety settings are enforced by the actual executable; 4) Be cautious because installing this will grant read (and copy) access to local files — avoid installing if you cannot review the code or trust the source. If you want a safer option, ask for a packaged release (verified GitHub release or an npm package) that you can audit before executing.

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.