FileX

A CLI agent to modify and interact with your files.

Installation

npm install -g filex-cli

Usage

Manual Commands

# Convert images to WebP
filex convert ./photos
filex convert ./photos --from png --to webp --quality 90

# Convert with resizing
filex convert ./photos --to jpg --max-width 1600

# Resize images
filex resize ./photos --max-width 800

# Merge PDFs
filex merge-pdfs ./documents
filex merge-pdfs ./documents --output combined.pdf --order date

AI-Powered Mode

Use natural language to describe what you want:

filex "convert all images here to webp"
filex "resize these photos to 1200px wide" --directory ./photos
filex "merge all the PDFs by date, newest first"
filex "convert png files to jpg at 90% quality"

Commands

| Command | Description | |---------|-------------| | convert <dir> | Convert images between formats | | resize <dir> | Resize images to a max width | | merge-pdfs <dir> | Merge all PDFs in a directory |

Options

convert

| Option | Description | Default | |--------|-------------|---------| | --from <format> | Source format (png, jpg, webp, gif, tiff, avif) | all | | --to <format> | Target format (webp, png, jpg) | webp | | --max-width <px> | Maximum width in pixels | — | | --quality <1-100> | Output quality | 80 |

resize

| Option | Description | |--------|-------------| | --max-width <px> | Maximum width in pixels (required) |

merge-pdfs

| Option | Description | Default | |--------|-------------|---------| | -o, --output <file> | Output filename | merged.pdf | | --order <type> | Sort: name, name-desc, date, date-desc, random | name |

Safety

• ✅ Originals preserved — All operations create new files
• ✅ Preview before write — Confirm planned actions first
• ✅ AI sandboxed — AI only parses intent, never touches files directly
• ✅ Works offline — Manual commands function without AI

License

MIT