/ak:storage upload assets/images/launch-hero.png

Use when:

A generated marketing asset should be hosted remotely after approval.

Expected:

Reads the local file, inspects destination collisions, sends PutObject when approved, and returns a constructed URL or a graceful unconfigured fallback instead of throwing.

/ak:storage download designs/pricing-deck.html

Use when:

One approved remote object should be written to a local path.

Expected:

Creates parent directories, writes the object bytes to the requested local path, and reports a missing-key or config error without crashing.

/ak:storage list designs/

Use when:

You need remote asset keys under a prefix without uploading or deleting anything.

Expected:

Lists a bounded object set for that prefix, or a fallback status when credentials or the SDK are missing, without changing public access.

/ak:storage sync assets/slides/

Use when:

A local asset folder should be mirrored for only the requested objects.

Expected:

Maps requested local files to remote keys, inspects collisions, does not delete remote objects, and keeps assets local if credentials are missing.

/ak:storage list designs/ --bucket campaign-assets

Use when:

The list must target a named bucket instead of the default S3_BUCKET.

Expected:

Overrides the bucket for that list only, still loads credentials from the user .env without logging them, and returns a bounded prefix listing or a graceful config error.