filesystem
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
- License 许可
- MIT
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- filesystem
- homepage
- https://github.com/gtrusler/clawdbot-filesystem
- metadata
- { "clawdbot": { "emoji": "📁", "requires": { "bins": [ "node" ] } } }
- description
- Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
02 资源文件 5
- 参考文档_meta.json294 B
- 参考文档config.json839 B
- 许可证LICENSE.md1.0 KB
- 参考文档package.json1.4 KB
- 参考文档README.md8.8 KB
03 SKILL.md 正文
📁 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.
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.