install

Additional install commands

macOS

Homebrewverified · 100%

brew install awscli-local

local Homebrew formula metadata

overview

Package summary

Thin wrapper around the aws command-line interface for use with LocalStack

Project links

Commands and aliases

awslocal
awslocal.bat

history

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 posture

No protected-tool coverage found yet

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.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 1 platform targets.
Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

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

Config paths the tool may read or write during local use.

Unix: ~/.aws/config
Windows: %USERPROFILE%\.aws\config

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: ~/.aws/credentials
Windows: %USERPROFILE%\.aws\credentials

executables

Installed executables

Command	Kind	Exposure	Note
`awslocal`	cli	global executable
`awslocal.bat`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.22.2

manager updated2026-05-12

local dataok

upstreamnot checked

latest detectednot detected

https://www.localstack.cloud/

infoRelease/tag comparison is only available for GitHub repositories.https://www.localstack.cloud/none confidence

install metadata

Package metadata

Package key	brew:awscli-local
Version	0.22.2
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/awscli-local
Homepage	https://www.localstack.cloud/
Repository	https://github.com/localstack/awscli-local
Upstream docs	https://docs.localstack.cloud/aws/integrations/aws-native-tools/aws-cli
License	Apache-2.0
Source archive	https://files.pythonhosted.org/packages/7a/71/591a30da6819c96deca2286f145d5982e73b11e7f657e8cbfc5e003ca73f/awscli_local-0.22.2.tar.gz
Last updated	2026-05-12T10:32:47Z
Pulse	updated
Dependencies	python@3.14
Bottle	available (on all)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	awscli-local
Version Scheme	0
Revision	3
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/awscli-local.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
package relationship graph
package version freshness
package-page enrichment

Install awscli-local with Homebrew