Skip to content

docs: add Phase 1 preview for new Go-based CLI (lstk)#504

Merged
quetzalliwrites merged 4 commits intomainfrom
docs-new-cli-phase1
Mar 23, 2026
Merged

docs: add Phase 1 preview for new Go-based CLI (lstk)#504
quetzalliwrites merged 4 commits intomainfrom
docs-new-cli-phase1

Conversation

@quetzalliwrites
Copy link
Collaborator

@quetzalliwrites quetzalliwrites commented Mar 19, 2026

Resolves: DOC-31

PREVIEW URL:
https://0c3d18ed.localstack-docs.pages.dev/aws/tooling/localstack-cli/#introduction

Updates the CLI reference documentation to include the initial release of the new LocalStack CLI (lstk).

Key changes:

  • Added a high-visibility Note at the top of the doc clarifying the phased rollout and the coexistence of both CLIs.
  • Documented current lstk commands (start, stop, status, etc.)
  • Clearly distinguished between the "New CLI Preview" and the "Legacy CLI" to ensure users understand that advanced features (i.e., Cloud Pods, Extensions) still require the legacy cli.
  • Documented new global options (--config, --non-interactive) of the flat command structure of new Go-based implementation.

The goal is to encourage early adoption for phase 1 rollout of new cli and encourage feedback for the new tooling; all without disrupting users who rely on stable advanced commands of the current cli (legacy cli).

initial release of the new LocalStack CLI
@quetzalliwrites quetzalliwrites self-assigned this Mar 19, 2026
@quetzalliwrites quetzalliwrites added the documentation Improvements or additions to documentation label Mar 19, 2026
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Mar 20, 2026

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c33976b
Status: ✅  Deploy successful!
Preview URL: https://d39390df.localstack-docs.pages.dev
Branch Preview URL: https://docs-new-cli-phase1.localstack-docs.pages.dev

View logs

Copy link
Member

@silv-io silv-io left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Copy link
Contributor

@anisaoshafi anisaoshafi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks Quetzalli!

We have lstk completion cmd as well, just in case you think it should go here.

@mmaureenliu
Copy link

LGTM, thanks Quetzalli!

We have lstk completion cmd as well, just in case you think it should go here.

We never documented that for localstack completion so maybe we can leave out detailed docs for all functionalities for now?

Copy link

@mmaureenliu mmaureenliu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've made some suggestions but if there's no capacity I'm happy for it to go out as is and we can address these later. Thanks for the great work!

@quetzalliwrites
Copy link
Collaborator Author

@quetzalliwrites quetzalliwrites merged commit 1970b60 into main Mar 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants