| name | iceage-batch |
| description | Batch compress all natural language files in a directory using iceage compression. Parallel workers, progress tracking, dry-run mode. Use when user says "compress all files", "batch compress", "compress this directory", or invokes /iceage-batch.
|
Compress all compressible files in a directory. Uses Claude API per file.
Usage
go run ./iceage-batch/go <directory> [flags]
Flags:
--dry-run — list files that would be compressed, no API calls--no-backup — skip creating .original.md backups (good for version-controlled dirs)--workers N — parallel compression (default 1, increase carefully — API rate limits apply)--recursive=false — top-level only, no subdirectories
Examples
go run ./iceage-batch/go docs/
go run ./iceage-batch/go docs/ --dry-run
go run ./iceage-batch/go docs/ --no-backup
go run ./iceage-batch/go docs/ --workers 3
go run ./iceage-batch/go . --recursive=false
Requirements
ANTHROPIC_API_KEY in environment or .env.local. Falls back to claude CLI if no key.
Output
Found 8 compressible file(s) in docs/
[1/8] docs/guide.md ... OK (1.2s)
[2/8] docs/api.md ... OK (0.9s)
[3/8] docs/old.md ... Skipped (backup exists)
[4/8] docs/broken.md ... FAILED (validation failed after retries)
Done
Compressed: 6
Skipped: 1
Failed: 1
Exit codes: 0 = all OK, 1 = fatal error, 2 = one or more files failed.
