# Install awscli-local with Homebrew Thin wrapper around the aws command-line interface for use with LocalStack. Version 0.22.2 via Homebrew; verified 2026-05-12. ## Install ```sh sudo av install brew:awscli-local ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install awscli-local ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:awscli-local - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.22.2 - **Source summary:** Thin wrapper around the aws command-line interface for use with LocalStack - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-05-12T10:32:47Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - awslocal (cli) - awslocal.bat (cli) - awslocal (alias) - awslocal.bat (alias) ## Dependencies - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.22.2 - Package-manager updated: 2026-05-12 - Local data: ok - Upstream repository: https://www.localstack.cloud/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage `awscli-local` provides the `awslocal` command, a thin wrapper around the AWS CLI for use with LocalStack. Its central job is to remove repetitive `--endpoint-url=http://localhost:4566` boilerplate while preserving the normal `aws` command shape. ### Project history The public GitHub repository and first PyPI upload both date to July 2017, early in LocalStack's effort to make local AWS service emulation feel like regular AWS tooling. The README changelog starts at v0.1 and tracks pragmatic wrapper fixes such as endpoint handling, Windows support, AWS CLI v1/v2 compatibility, and CloudFormation package workarounds. The package stayed intentionally small: the README says it can mostly be replaced by a shell alias except for cases like CloudFormation packaging that require extra endpoint handling. ### Adoption history The project is packaged on PyPI and Homebrew. GitHub repository metadata showed around a thousand stars in June 2026, and Homebrew analytics showed hundreds of 30-day installs, reflecting LocalStack users who prefer a named wrapper over manually managing endpoint flags. Its adoption follows LocalStack adoption: as developers write tests and local integration workflows against emulated AWS services, `awslocal` becomes a convenience command that keeps examples and scripts close to real AWS CLI usage. ### How it is used The normal pattern is replacing `aws --endpoint-url=http://localhost:4566 kinesis list-streams` with `awslocal kinesis list-streams`. The README documents environment variables such as `AWS_ENDPOINT_URL`, `LOCALSTACK_HOST`, and `USE_SSL`, plus shell completion registration for `awslocal` alongside `aws`. Because it wraps the AWS CLI, it inherits the AWS CLI config and credentials file conventions even when LocalStack examples often use placeholder credentials. ### Why package nerds care For package nerds, `awscli-local` is a model of a deliberately boring wrapper: a small command that survives because it standardizes a repeated local-development incantation. It also shows why wrapper packages keep existing even when an alias is possible: packages travel through PyPI, Homebrew, CI images, and docs more predictably than a private shell function. ### Timeline - 2017-07: Public GitHub repository created. - 2017-07: awscli-local 0.1 uploaded to PyPI. - 2025-08: awscli-local 0.22.2 uploaded to PyPI. - 2026-06: Homebrew formula tracked 0.22.2. ### Related projects - `localstack/localstack` is the emulator ecosystem that gives `awslocal` its purpose. - The upstream README points out that an alias can replace the wrapper for simple AWS CLI calls, but not every patched/endpoint-heavy workflow. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for awscli-local. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.aws/config - Windows: %USERPROFILE%\.aws\config ## Credential files - Unix: ~/.aws/credentials - Windows: %USERPROFILE%\.aws\credentials ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** awscli-local - **Version Scheme:** 0 - **Revision:** 3 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [terraform-local](https://www.automicvault.com/pkg/brew/terraform-local/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure, localstack. - [amazon-ecs-cli](https://www.automicvault.com/pkg/brew/amazon-ecs-cli/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-amplify](https://www.automicvault.com/pkg/brew/aws-amplify/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-cdk](https://www.automicvault.com/pkg/brew/aws-cdk/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-console](https://www.automicvault.com/pkg/brew/aws-console/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-elasticbeanstalk](https://www.automicvault.com/pkg/brew/aws-elasticbeanstalk/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-es-proxy](https://www.automicvault.com/pkg/brew/aws-es-proxy/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [aws-google-auth](https://www.automicvault.com/pkg/brew/aws-google-auth/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure. - [awscli](https://www.automicvault.com/pkg/brew/awscli/) - Both packages touch the same language runtime or ecosystem. Shared terms: aws, awscli, cli, cloud, cloud-infrastructure. - [awsume](https://www.automicvault.com/pkg/brew/awsume/) - Both packages touch the same language runtime or ecosystem. Shared terms: aws, bat, cli, cloud, cloud-infrastructure. ## Combined YAML source View the package source record on GitHub. [combined/awscli-local.yml](https://github.com/automic-vault/db/blob/main/combined/awscli-local.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph