iceage-batch

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.