A command-line interface for LocalStack. Built in Go with a modern terminal UI and native CLI experience for managing and interacting with LocalStack deployments. 👾
npm install -g @localstack/lstkSee Installation for other install methods.
- Docker — required as a container engine.
- LocalStack account — required for credentials, the CLI will guide you through authentication.
brew install localstack/tap/lstknpm install -g @localstack/lstkPre-built binaries are also available from GitHub Releases. 📦
lstkRunning lstk will automatically handle authentication, configuration, and container setup, then start LocalStack. On the first interactive run, it also prompts you to pick which emulator to run (AWS, Azure, or Snowflake) and remembers your choice.
- Start / stop / status / logs — manage the full LocalStack emulator lifecycle with a single command
- Interactive TUI — a Bubble Tea-powered terminal UI in interactive terminals, plain output for CI/CD and scripting
- Browser-based login — authenticate via browser and store credentials securely in the system keyring, or use
LOCALSTACK_AUTH_TOKENfor CI - Snapshots — save, load, and manage emulator state as local files, cloud snapshots, or in your own S3 bucket
- Cloud CLI proxies — run
aws,az,terraform,cdk, andsamcommands against LocalStack with the endpoint, credentials, and region pre-configured - Extensions — Git-style
lstk-<name>executables extend the CLI with new commands; see docs/extensions-authoring.md - Self-update —
lstk updatechecks for and installs the latest release - Structured JSON output — pass
--jsonto a supported command for a machine-readable envelope instead of formatted text; see docs/structured-output.md
For the full command reference, configuration options, environment variables, and troubleshooting, see the lstk documentation.
See CONTRIBUTING.md for development setup, architecture, and pull request guidelines.
Feedback is welcome! Use the repository issue tracker for bug reports or feature requests.