docs(lstk): update CLI reference to v0.16.0

[gtsiolis]

Summary

Brings the lstk CLI reference up to date with the current CLI. The doc previously reflected roughly v0.13.0 (last meaningfully expanded in localstack-docs #701, merged 2026-06-24). This PR catches up the full backlog through the latest release, v0.16.0 — covering v0.14.0, v0.14.1, v0.15.0, and v0.16.0.

Rather than trust a diff, I walked the live CLI surface (lstk --help and every subcommand's --help, plus the config/env source), so this flags stale content as well as additions.

New commands / features documented

• Developer tool proxies — the Tools group in help: lstk az (Azure CLI, incl. start-interception/stop-interception), lstk terraform (alias tf), lstk cdk, and lstk sam, each with its lstk-specific flags, version requirements, and supported env vars.
• lstk setup azure (alias setup az) — isolated Azure CLI config directory.
• snapshot show — metadata for a cloud snapshot.
• S3 remotes for snapshot save / load / list (own-bucket storage, --profile, credential precedence, running-emulator requirement).
• Snapshot auto-load on start — the snapshot config field and the --snapshot / --no-snapshot flags.
• New config fields — image (custom/mirror/offline image), volumes (bind mounts + init hooks); added Custom container image and Volume mounts sections.
• Global flags — --json, --snapshot, --no-snapshot.
• New sections — Offline and enterprise environments (graceful degradation, local-image fallback, ESC-to-abort pull) and Extensions (Git-style lstk-<name>).
• Container-injected vars — LOCALSTACK_CLIENT_NAME / LOCALSTACK_CLIENT_VERSION, and a note on GATEWAY_LISTEN host exposure.

Stale content corrected

• Removed the lstk config profile section — that command was deleted from the CLI (lstk Upgrade Starlight and dependencies #360); replaced with a note pointing to setup aws.
• setup aws no longer "requires an interactive terminal" — it now runs non-interactively (writes the profile with defaults) and gained a --force flag. Fixed the command section and the interactive/non-interactive note.
• Snapshots are no longer AWS-only — snapshot save/load now work for Snowflake and Azure with an "experimental" warning; only reset remains AWS-only. Updated the note accordingly.

Notes for reviewers

• No public-messaging wording changes; all edits describe existing shipped behavior and keep the doc's structure and voice.
• The Cloudflare Pages preview builds cleanly, and the new MDX mirrors the patterns already used in this file (:::note/:::caution directives balanced, all interpolation kept inside code spans).
• One thing worth a human eye: the Snowflake/Azure snapshot support is described as "experimental and not fully tested" (matching the CLI's own warning text) — confirm that's the messaging you want in public docs.

Cc @localstack/devx for visibility and any corrections.

[cloudflare-workers-and-pages]

Deploying localstack-docs with    Cloudflare Pages

Latest commit:	076b02c
Status:	✅  Deploy successful!
Preview URL:	https://65d8c703.localstack-docs.pages.dev
Branch Preview URL:	https://claude-wonderful-lovelace-f8.localstack-docs.pages.dev

View logs

[gtsiolis]

@mmaureenliu could you take a look?
Cc @quetzalliwrites for aiming to merge this before Thursday's (Jul 16) release if possible.

[mmaureenliu]

Thanks for the effort!

[gtsiolis]

Thanks for the review! Addressed the feedback in bdf0a8e:

• Intro (L23): dropped the "*local wrapper" phrasing — tools now just "run directly against LocalStack".
• Emulator types (L218): reworded to "the default aws emulator is used if no config file is found".
• AWS-only list (L221): removed snapshot (it now works for all emulators).
• az interception (L577): changed "Prefer" → "Use" so it doesn't conflict with the Azure docs' preferred mode.
• terraform (L580): added a note that lstk terraform currently targets AWS only, pointing to the relevant emulator docs otherwise.
• Extensions section (L1231): removed (deferred).

One I left as-is: the intro/notes duplication (L17) — you wanted @quetzalliwrites's take first, so I haven't touched it pending that.

---

Generated by Claude Code

[gtsiolis]

Done in f5b86f7 — deleted the intro note component and kept only its second sentence (the tool-proxy list) as a plain paragraph. That was the last open item from the review; all threads should now be addressed. Thanks @quetzalliwrites, @mmaureenliu!

---

Generated by Claude Code

[gtsiolis]

Small heads-up on the dash→parenthesis change (intro, line 18): the closing em-dash was doing double duty as the clause separator, so the sentence now needs a comma after the parenthesis:

It can also save and load emulator state (as local snapshots or Cloud Pods), reset running state, run AWS CLI commands against the emulator, and manage the on-disk volume.

Happy to push that one-character fix if you'd prefer, or leave it to your style pass — your call, @quetzalliwrites.

---

Generated by Claude Code

[quetzalliwrites]

ty @gtsiolis for your contribution, you always place such detailed thought into each PR 🌈

[quetzalliwrites]

@gtsiolis let me get back to you before eod on merging this PR, i agree this can/should go live before end of month july aws release

[quetzalliwrites]

merging as a hotfix since this is not aws release dependent

[quetzalliwrites]

@gtsiolis Holaaa George, a quick reminder regarding PR coordination: When I am actively preparing PRs and managing branch movements, do not make mid-process updates to those branches.

Your recent update accidentally caused this PR to merge into the August release branch instead of main. I know you were likely trying to fix it thinking I mistakenly targetted the main branch, but it disrupted the release flow, and I now have to revert and restart the process.

Moving forward, if you see me actively working on or merging docs PRs, check in with me before making any adjustments so we don't override active work. Thanks for understanding.