From 2341a9161b8574e74f6d75eb36a2c30543d5da54 Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Fri, 12 Jun 2026 14:03:25 +0300 Subject: [PATCH 1/4] Mention the lstk CLI in the localstack CLI docs --- scripts/generate_cli_docs.py | 11 +++-------- .../running-localstack/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 a45d84c7..3cd45792 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/developer-tools/running-localstack/localstack-cli.md b/src/content/docs/aws/developer-tools/running-localstack/localstack-cli.md index 699bbf6d..2c69cbc0 100644 --- a/src/content/docs/aws/developer-tools/running-localstack/localstack-cli.md +++ b/src/content/docs/aws/developer-tools/running-localstack/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.5.3`. +[`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 c43d20e3c55e102266cd1499ce240ca51ed5412e Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Fri, 12 Jun 2026 14:24:06 +0300 Subject: [PATCH 2/4] Align the lstk page note and FAQ with snapshot support --- .../docs/aws/developer-tools/running-localstack/lstk.mdx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx b/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx index 290bc8d7..0fcb2870 100644 --- a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx +++ b/src/content/docs/aws/developer-tools/running-localstack/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/developer-tools/running-localstack/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? From e22353cf969c0bd365731ef5fbb3baf2ffd20794 Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Tue, 16 Jun 2026 12:43:04 +0300 Subject: [PATCH 3/4] Point lstk and localstack CLI links at relocated Developer Tools paths The Developer Tools restructure (#691) moved the localstack-cli and lstk pages under /aws/developer-tools/running-localstack/. Update the cross-links in the generated CLI doc, its generator, and the lstk FAQ to match. Co-Authored-By: Claude Opus 4.8 --- scripts/generate_cli_docs.py | 2 +- .../aws/developer-tools/running-localstack/localstack-cli.md | 2 +- .../docs/aws/developer-tools/running-localstack/lstk.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/scripts/generate_cli_docs.py b/scripts/generate_cli_docs.py index 3cd45792..81271d32 100644 --- a/scripts/generate_cli_docs.py +++ b/scripts/generate_cli_docs.py @@ -212,7 +212,7 @@ def generate_documentation( "To install the LocalStack CLI, follow the [installation guide](/aws/getting-started/installation/#installing-localstack-cli).", "", ":::note", - "[`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.", + "[`lstk`](/aws/developer-tools/running-localstack/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", diff --git a/src/content/docs/aws/developer-tools/running-localstack/localstack-cli.md b/src/content/docs/aws/developer-tools/running-localstack/localstack-cli.md index 2c69cbc0..184fac03 100644 --- a/src/content/docs/aws/developer-tools/running-localstack/localstack-cli.md +++ b/src/content/docs/aws/developer-tools/running-localstack/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 -[`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. +[`lstk`](/aws/developer-tools/running-localstack/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 diff --git a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx b/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx index 0fcb2870..8af1257e 100644 --- a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx +++ b/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx @@ -457,7 +457,7 @@ 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, and both work with Cloud Pods — `lstk` via its `snapshot` command and the [`localstack` CLI](/aws/tooling/localstack-cli/) via its `pod` command. +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/developer-tools/running-localstack/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. From 852edeec4797ac79923386f42bfc0d66673bcb6e Mon Sep 17 00:00:00 2001 From: George Tsiolis Date: Tue, 16 Jun 2026 12:54:56 +0300 Subject: [PATCH 4/4] Remove the lstk vs localstack CLI FAQ section Keep the lstk doc focused only on lstk. With the localstack CLI being deprecated, the doc shouldn't compare against it or highlight features (Extensions, Ephemeral Instances) that lstk won't add. Discoverability of lstk still flows from the localstack CLI page note, which is unchanged. Co-Authored-By: Claude Opus 4.8 --- .../docs/aws/developer-tools/running-localstack/lstk.mdx | 8 -------- 1 file changed, 8 deletions(-) diff --git a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx b/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx index 8af1257e..d3d7a03e 100644 --- a/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx +++ b/src/content/docs/aws/developer-tools/running-localstack/lstk.mdx @@ -455,14 +455,6 @@ Restart your shell after persisting completions. ## FAQ -### What is the difference between `lstk` and the `localstack` CLI? - -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/developer-tools/running-localstack/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 workflows and the `localstack` CLI when you need its additional platform features. - ### Can I use `lstk` with Docker Compose? No. `lstk` manages its own Docker container directly.