x-zuz

# x-zuz - Unified Archive/Compression (AI Optimized) `x-zuz` is a powerful archive processing module. Its core advantages are a **unified interface** and **zero-dependency auto-installation** (it automatically handles missing backends like 7zip or zstd). ## Core Aliases - `x z`: Alias for compression (zuz compress) - `x uz`: Alias for decompression (zuz decompress) ## When to Activate - When multiple files or directories need to be packed into a specific format. - When extracting any common archive format (zip, tar.gz, 7z, etc.). - When listing the contents of an archive without extracting it. - When extracting and immediately deleting the source file to save space. ## Core Principles & Rules - **Non-interactive First**: Avoid interactive UIs; use command parameters directly. - **Universal Interface**: No need to remember different extraction commands (like `tar -zxvf` or `unzip`); use `x uz` for everything. - **Environment Isolation**: Automatically downloads required backends, ensuring operation in any minimal environment. ## Patterns & Examples ### Quick Compression ```bash # Compress the 'src' directory into output.tar.gz x z output.tar.gz src/ # Compress multiple files into a zip x z archive.zip file1.txt file2.txt ``` ### Quick Extraction ```bash # Extract to the current directory x uz archive.zip # Extract to a specific directory x uz backup.tar.xz ./target_dir/ ``` ### View Archive Contents (Non-interactive) ```bash # List files inside an archive x zuz ls archive.7z ``` ### Extract and Delete Source (Cleanup Mode) ```bash # Ideal for handling temporary downloads x uzr data.zip ``` ## Checklist - [ ] Prioritize using aliases `x z` or `x uz`. - [ ] Confirm the target path exists. - [ ] Consider using `x uzr` for automatic cleanup.