ls

storage ls [prefix] [--limit n] [--cursor token]

List objects under an optional prefix. Human mode prints one path per line so the output pipes cleanly into xargs, grep, and friends; JSON mode emits the full ListResult ({ items, cursor? }).

storage ls
storage ls photos/
storage ls photos/ --limit 100

Flags

• --adapter <name> (required, or set STORAGE_ADAPTER) — pick the adapter.
• --snapshot <id> — scope the read into a snapshot.
• --fork <name> — scope the read into a fork.
• --limit <n> — non-negative integer cap on the number of items returned.
• --cursor <token> — pagination cursor returned by a previous call.
• --json / --no-json — force JSON or human output.

Pagination

--limit and --cursor together let you walk a large bucket. In human mode the cursor prints to stderr so the paths on stdout stay clean to pipe:

cursor=$(storage ls --limit 1000 2> >(grep -oE 'cursor: .*' | cut -d' ' -f2))
storage ls --limit 1000 --cursor "$cursor"