# 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
- **Version:** 0.22.2
- **Source summary:** Thin wrapper around the aws command-line interface for use with LocalStack
- **Homepage:** <https://www.localstack.cloud/>
- **Last updated:** 2026-05-12T10:32:47Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- awslocal (alias)
- awslocal.bat (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.22.2
## 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

- <https://docs.localstack.cloud/aws/integrations/aws-native-tools/aws-cli/>
- <https://formulae.brew.sh/api/formula/awscli-local.json>
- <https://github.com/localstack/awscli-local>
- <https://pypi.org/pypi/awscli-local/json>
- <https://raw.githubusercontent.com/localstack/awscli-local/master/README.md>


## 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

## Combined YAML source

View the package source record on GitHub. [combined/awscli-local.yml](https://github.com/mxcl/pkgdb/blob/main/combined/awscli-local.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph