localstack — Claude Code plugin: features and installation
This plugin equips Claude Code with skills for running LocalStack, deploying cloud infrastructure, and investigating failures. Use it when building or testing AWS applications against a local environment.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install localstack@claude-communityWhat localstack does
The plugin groups skills around the main LocalStack development tasks. It covers emulator control through lstk, infrastructure deployment with Terraform, CDK, CloudFormation, and SAM, plus log inspection for troubleshooting. Other skills handle snapshots and Cloud Pods, review IAM policies and generate least-privilege permissions, or manage LocalStack extensions.
You need Docker running, a LocalStack account with an authentication token, and the lstk CLI. Install the infrastructure tools you intend to use and make sure they are on your PATH. Commands such as lstk aws, lstk terraform, lstk cdk, and lstk sam route supported tools to LocalStack. Pulumi requires pulumilocal because lstk does not provide a Pulumi proxy.
To install the plugin in Claude Code, add the community marketplace and then install localstack@claude-community. The older localstack CLI remains relevant for extension management and certain IAM policy generators, but it is deprecated. It controls its own container, so stop its emulator before starting another CLI's emulator to avoid running both at once.
What it helps with
- Start, stop, restart, or inspect a LocalStack environment
- Deploy AWS infrastructure with Terraform or CloudFormation
- Trace service failures by examining LocalStack logs
- Review IAM policies and generate least-privilege permissions
- Save and restore environment state using snapshots or Cloud Pods
Example prompts for the agent
- Start LocalStack with
lstkand check whether the local environment is running. - Deploy my infrastructure to LocalStack with Terraform and investigate any deployment errors.
- Inspect the LocalStack logs, review the IAM policy, and suggest the minimum permissions required.
How to install localstack
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install localstack@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about localstack
How do I install localstack in Claude Code?
Run /plugin marketplace add anthropics/claude-plugins-community, then run /plugin install localstack@claude-community. Before using the skills, start Docker, obtain a LocalStack account and auth token, and install the lstk CLI.
What does the localstack plugin do?
It adds Claude Code skills for LocalStack lifecycle management, infrastructure deployment, log debugging, and IAM policy analysis. It also supports state snapshots, Cloud Pods, and extension management.
Which dependencies does localstack need?
You need Docker, a LocalStack account with an auth token, and lstk. Put the infrastructure tools you plan to run on your PATH. Pulumi deployments need pulumilocal; certain container-based Lambda deployments and nested CloudFormation stacks require samlocal.
Source text
SKILL.md · Apache-2.0
# LocalStack AI Skills AI Agent Skills for developing and testing cloud applications against [LocalStack](https://localstack.cloud) - the local cloud development platform. ## Overview This repository contains a collection of AI skills designed to help developers work more efficiently with LocalStack. These skills enable AI assistants to help with common LocalStack workflows, from managing the local environment to deploying infrastructure and analyzing logs. ## Available Skills | Skill | Description | |-------|-------------| | [localstack-lifecycle](skills/localstack-lifecycle/) | Manage the emulator lifecycle with `lstk` (start, stop, status, restart, reset) | | [iac-deployment](skills/iac-deployment/) | Deploy infrastructure using Terraform, CDK, CloudFormation, SAM, and Pulumi | | [state-management](skills/state-management/) | Save, load, and manage LocalStack state with snapshots and Cloud Pods | | [logs-analysis](skills/logs-analysis/) | Analyze LocalStack logs, identify errors, and debug issues | | [iam-policy-analyzer](skills/iam-policy-analyzer/) | Analyze IAM policies and auto-generate least-privilege permissions | | [localstack-extensions](skills/localstack-extensions/) | Manage LocalStack extensions and plugins (legacy CLI) | ## Installation ### Via the LocalStack standalone marketplace ```bash claude plugin marketplace add localstack/skills claude plugin install localstack@localstack-dev ``` ## Prerequisites - Docker running on your machine - A [LocalStack account](https://app.localstack.cloud/) and auth token - The [`lstk` CLI](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/), the current LocalStack CLI: ```bash # Homebrew (macOS/Linux) brew install localstack/tap/lstk # npm npm install -g @localstack/lstk # Authenticate lstk login ``` - The tools you want `lstk` to proxy, on your `PATH`: [AWS CLI](https://aws.amazon.com/cli/), `terraform`, `cdk`, or `sam`. `lstk aws`, `lstk terraform`, `lstk cdk`, and `lstk sam` point them at LocalStack for you, replacing the `awslocal`, `tflocal`, `cdklocal`, and `samlocal` wrappers. ### Optional extra CLIs The `lstk` CLI does not cover every workflow yet. Install these only if you need them: | Tool | Install | Needed for | |------|---------|-----------| | `pulumilocal` | `pip install pulumi-local` | Pulumi deployments — `lstk` has no Pulumi proxy | | `samlocal` | `pip install aws-sam-cli-local` | Image/container-based Lambda (ECR) deploys and nested CloudFormation stacks, which `lstk sam` does not support | | legacy `localstack` CLI | `pip install localstack` | LocalStack Extensions, and the `localstack aws iam stream` / `summary` policy generators | The legacy `localstack` CLI is deprecated and will be removed in a future version — use it only for the gaps listed above. It manages its own container, so stop one CLI's emulator before starting the other's. ## Usage These skills are designed to be used with AI coding assistants that support the skills/commands interface. Each skill provides contextual guidance and commands for specific LocalStack workflows. ## Related Projects - [LocalStack](https://github.com/localstack/localstack) - The core LocalStack platform - [LocalStack MCP Server](https://github.com/localstack/localstack-mcp-server) - Model Context Protocol server for LocalStack - [LocalStack Documentation](https://docs.localstack.cloud/) ## License Apache License 2.0 - see [LICENSE](LICENSE) for details.
© localstack · Apache-2.0 · localstack/skills
