Bulk File Operations

Jump to bottom

RenzMc edited this page Sep 6, 2025 · 1 revision

📁 Bulk File Operations

This guide explains how to use the bulk file operations features of the Acode AI CLI Assistant Plugin to manage multiple files efficiently.

🎯 Overview

Bulk file operations allow you to perform actions on multiple files simultaneously, saving time and effort in project management tasks.

🛠️ Available Operations

Rename Multiple Files

Rename several files at once using patterns
Use {index} placeholder for sequential numbering
Preview changes before applying

Move Files to Folders

Organize multiple files into appropriate directories
Select target folder through file browser
Maintain file structure and references

Delete Unused Files

Remove temporary, backup, or log files
Specify file extensions to target
Safely clean up your project

Add Headers to Files

Insert consistent headers across multiple files
Customize header content
Apply to selected files or entire project

Convert File Formats

Change file extensions in bulk
Convert between compatible formats
Maintain file content integrity

📱 Accessing Bulk Operations

From Chat Interface

Open the AI assistant chat
Click the menu icon (three dots)
Select "Bulk Operations"

Keyboard Shortcut

Windows/Linux: Ctrl + Shift + B
Mac: Cmd + Shift + B

🔧 Using Rename Operation

Pattern-Based Renaming

Select "Rename multiple files" from the operations menu
Choose files to rename using the file selection interface
Enter a naming pattern (e.g., component_{index}.js)
Preview the changes
Confirm to apply renaming

AI-Assisted Renaming

Select "Rename multiple files"
Choose files to rename
Select "AI Rename" option
AI will suggest appropriate names based on file content
Review and confirm suggestions

📁 Using Move Operation

Organizing Files

Select "Move files to folders" from operations menu
Choose files to move
Select target directory through file browser
Preview file movements
Confirm to apply changes

AI-Based Organization

Select "Move files to folders"
Choose files to organize
Select "AI Organize" option
AI analyzes file content and suggests appropriate folders
Review and confirm organization

🗑️ Using Delete Operation

Cleanup Process

Select "Delete unused files" from operations menu
Specify file extensions to target (e.g., .log, .tmp, .bak)
AI scans project for matching files
Review list of files to be deleted
Confirm deletion

Safety Features

Files are not permanently deleted immediately
Preview of all files to be removed
Confirmation step prevents accidental deletion

📄 Using Header Addition

Adding Headers

Select "Add headers to files" from operations menu
Choose files to add headers to
Enter or generate header content
Preview headers
Confirm to apply to all selected files

Header Templates

Create reusable header templates
Include dynamic elements like date, filename, author
Apply consistently across your project

🔄 Using Format Conversion

Converting Files

Select "Convert file formats" from operations menu
Choose files to convert
Specify target format/extension
Preview conversions
Confirm to apply changes

Format Compatibility

Only converts between compatible formats
Maintains file content during conversion
Preserves file metadata when possible

🤖 AI Integration in Bulk Operations

Smart File Analysis

AI examines file content to suggest appropriate actions
Context-aware recommendations for organization
Intelligent pattern generation for renaming

Project Structure Understanding

AI analyzes your entire project structure
Suggests improvements based on best practices
Recommends folder organization patterns

⚙️ Configuration Options

Default Patterns

Set default naming patterns for common operations
Configure frequently-used header templates
Save preferred folder structures

Performance Settings

Adjust how many files are processed simultaneously
Set timeout values for AI analysis
Configure cache settings for repeated operations

📈 Bulk Operation Tracking

Operation History

Track all bulk operations performed
View success/failure statistics
Undo recent operations if needed

Token Usage

Monitor API token consumption during bulk operations
Estimate costs before performing large operations
Optimize operations for token efficiency

🐛 Troubleshooting Bulk Operations

Common Issues

File Selection Problems

Ensure you have proper permissions for selected files
Check that files are not locked by other processes
Verify file paths are accessible

Operation Failures

Some operations may fail due to file permissions
Network issues can affect AI-assisted operations
Large operations may timeout on slower devices

Unexpected Results

Preview all operations before confirming
AI suggestions may not always match your intent
Customize AI prompts for better results

Bulk Operations Verification

To verify bulk operations functionality:

Create a test directory with several files
Access bulk operations through menu or shortcut
Try a simple rename operation with a few files
Confirm files are properly renamed

💡 Best Practices

Before Performing Bulk Operations

Always backup important files
Preview changes before confirming
Start with small batches to test
Ensure sufficient API quota if using AI features

Efficient Renaming

Use descriptive patterns that reflect file purpose
Include version numbers when appropriate
Maintain consistency across your project

Safe Deletion

Only delete files you're certain you don't need
Check file extensions carefully
Consider moving files to a "trash" folder first

📞 Getting Help

If you encounter issues with bulk file operations:

Check the Common Issues documentation
Visit our GitHub Issues page
Join our Discussions community for support

🏠 Home | ⬆ Back to Top | 📊 Project Organization