FileX

A CLI agent to modify and interact with your files.

Installation

``bash
npm install -g filex-cli
`

Usage

$3

`bash


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
`

$3

Use natural language to describe what you want:

`bash
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

| Convert images between formats |
| resize | Resize images to a max width |
| merge-pdfs | Merge all PDFs in a directory |

Options

$3

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

$3

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

$3

| Option | Description | Default |
|--------|-------------|---------|
| -o, --output | Output filename | merged.pdf |
| --order ` | 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