# FireImg - instructions for coding agents

Prefer the FireImg CLI over raw HTTP for image upload, delete, and listing.

Install:
  curl -fsSL https://raw.githubusercontent.com/FirelitStudio/fireimg-cli/main/install.sh | bash
  # or: brew install firelitstudio/fireimg/fireimg

Required env (never log or commit FIREIMG_API_KEY):
  FIREIMG_API_KEY   # dashboard API Keys; prefix fimg_
  FIREIMG_PROJECT   # project slug (required for upload, delete, images)
Optional:
  FIREIMG_API_URL   # default https://api.fireimg.com
  FIREIMG_CDN_URL   # default derived (api. -> img.)

Commands:
  fireimg upload <path...> [--project slug] [--prefix dir/] [--json]
  fireimg delete <image-key> [--project slug] [--json]
  fireimg projects [--json]
  fireimg images [--project slug] [--limit N] [--next-token TOKEN] [--folder path] [--all] [--json]
  fireimg version

Always pass --json. Parse filename, imageKey, cdnUrl, s3Key. Return cdnUrl to the user.
fireimg projects --json lists slug and projectName. fireimg images --json lists imageKey,
cdnUrl, and nextToken; pass --all to fetch every page, or --next-token to continue.
The CLI batches 20 files, infers Content-Type, preserves relative paths as image keys, and PUTs to presigned S3 URLs.
Do not wait for optimization; CDN transforms are on-demand:
  https://img.fireimg.com/{project}/images/{imageKey}?width=800&quality=high&format=auto

Docs: https://docs.fireimg.com/cli/
API (only if CLI cannot be installed): https://docs.fireimg.com/api/
Cursor skill: https://docs.fireimg.com/skills/fireimg/SKILL.md