From d9804091e44c36f1aebfa550647a312e548dea5f Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Fri, 12 Jun 2026 14:03:25 +0300 Subject: [PATCH 1/2] Mention the lstk CLI in the localstack CLI docs --- scripts/generate_cli_docs.py | 11 +++-------- src/content/docs/aws/tooling/localstack-cli.md | 2 +- 2 files changed, 4 insertions(+), 9 deletions(-) diff --git a/scripts/generate_cli_docs.py b/scripts/generate_cli_docs.py index a45d84c79..3cd45792c 100644 --- a/scripts/generate_cli_docs.py +++ b/scripts/generate_cli_docs.py @@ -187,9 +187,8 @@ def generate_command_section(cmd: Command) -> list[str]: def generate_documentation( - regular_commands: list[Command], + regular_commands: list[Command], advanced_commands: list[Command], - version: str ) -> str: """Generate the complete markdown documentation.""" doc_lines = [] @@ -213,7 +212,7 @@ def generate_documentation( "To install the LocalStack CLI, follow the [installation guide](/aws/getting-started/installation/#installing-localstack-cli).", "", ":::note", - f"This documentation was auto-generated from LocalStack CLI version `{version}`.", + "[`lstk`](/aws/tooling/lstk/) is our new Go-based CLI with an interactive terminal UI for lifecycle (`start`, `stop`), monitoring (`status`, `logs`), storage (`snapshot`), and more.", ":::", "", "## Global Options", @@ -282,10 +281,6 @@ def main() -> None: total = len(regular_commands) + len(advanced_commands) print(f"Found {len(regular_commands)} commands and {len(advanced_commands)} advanced commands", file=sys.stderr) - # Get version - version_output = run_command(["localstack", "--version"]) - version = version_output.strip() if version_output else "latest" - # Populate details for each command (including subcommands) all_commands = regular_commands + advanced_commands for i, cmd in enumerate(all_commands): @@ -293,7 +288,7 @@ def main() -> None: populate_command_details(cmd) print("Generating documentation...", file=sys.stderr) - documentation = generate_documentation(regular_commands, advanced_commands, version) + documentation = generate_documentation(regular_commands, advanced_commands) if args.dry_run: print(documentation) diff --git a/src/content/docs/aws/tooling/localstack-cli.md b/src/content/docs/aws/tooling/localstack-cli.md index c0f3f4758..b37bd3580 100644 --- a/src/content/docs/aws/tooling/localstack-cli.md +++ b/src/content/docs/aws/tooling/localstack-cli.md @@ -15,7 +15,7 @@ It provides convenience features to interact with LocalStack features like Cloud To install the LocalStack CLI, follow the [installation guide](/aws/getting-started/installation/#installing-localstack-cli). :::note -This documentation was auto-generated from LocalStack CLI version `LocalStack CLI 2026.4.0`. +[`lstk`](/aws/tooling/lstk/) is our new Go-based CLI with an interactive terminal UI for lifecycle (`start`, `stop`), monitoring (`status`, `logs`), storage (`snapshot`), and more. ::: ## Global Options From 83eab98a8bb9e8978765d477dc4b74213bf34ab6 Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Fri, 12 Jun 2026 14:24:06 +0300 Subject: [PATCH 2/2] Align the lstk page note and FAQ with snapshot support --- src/content/docs/aws/tooling/lstk.mdx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/content/docs/aws/tooling/lstk.mdx b/src/content/docs/aws/tooling/lstk.mdx index 85e0edafd..0fcb28700 100644 --- a/src/content/docs/aws/tooling/lstk.mdx +++ b/src/content/docs/aws/tooling/lstk.mdx @@ -18,8 +18,7 @@ It provides a built-in terminal UI (TUI) for interactive use and plain text outp Running `lstk` with no arguments takes you through the entire flow automatically. :::note -`lstk` is in early release and does not yet support advanced features like **Cloud Pods**, **Extensions**, and **Ephemeral Instances**. For these features, use the [LocalStack CLI](/aws/tooling/localstack-cli/). -Both tools can be installed and used on the same machine. +`lstk` covers the everyday emulator workflow: lifecycle (`start`, `stop`), monitoring (`status`, `logs`), storage (`snapshot`), and more. ::: ## Prerequisites @@ -458,11 +457,11 @@ Restart your shell after persisting completions. ### What is the difference between `lstk` and the `localstack` CLI? -Both tools can start, stop, and manage the LocalStack emulator. -`lstk` is a newer CLI built in Go with a TUI, while the `localstack` CLI is the established Python-based tool with support for Cloud Pods, Extensions, Ephemeral Instances, and other advanced features. +Both tools can start, stop, and manage the LocalStack emulator, and both work with Cloud Pods — `lstk` via its `snapshot` command and the [`localstack` CLI](/aws/tooling/localstack-cli/) via its `pod` command. +`lstk` is a newer CLI built in Go with a TUI; the `localstack` CLI is the established Python-based tool that additionally supports Extensions, Ephemeral Instances, and other advanced features `lstk` doesn't cover yet. Both can be installed side by side. -Use `lstk` for fast daily start/stop workflows and `localstack` for advanced platform features. +Use `lstk` for fast daily workflows and the `localstack` CLI when you need its additional platform features. ### Can I use `lstk` with Docker Compose?