# Install awsweeper with Homebrew, Nix

CLI tool for cleaning your AWS account. Version 0.12.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:awsweeper
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install awsweeper
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#awsweeper
```

  Evidence: nixpkgs package indexes: pkgs/by-name/aw/awsweeper/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:awsweeper
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/awsweeper>
- **Version:** 0.12.0
- **Source summary:** CLI tool for cleaning your AWS account
- **Homepage:** <https://github.com/jckuester/awsweeper/>
- **Repository:** <https://github.com/jckuester/awsweeper>
- **Upstream docs:** <https://github.com/jckuester/awsweeper#readme>
- **License:** MPL-2.0
- **Source archive:** <https://github.com/jckuester/awsweeper/archive/refs/tags/v0.12.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- awsweeper (cli)
- awsweeper (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.12.0
- Local data: ok
- Upstream repository: https://github.com/jckuester/awsweeper
- Upstream latest detected: v0.12.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

AWSweeper is a Go command-line tool for deleting selected AWS resources from an account using a YAML filter file. It belongs to the small but important class of cloud cleanup tools that exist because real AWS accounts accumulate test, orphaned, and policy-violating resources faster than humans can remove them by hand.

### Project history

The official GitHub repository was created in July 2017, and the first GitHub release listed by the repository is v0.1.0 from November 2017. The README describes AWSweeper as a tool for cleaning AWS accounts and explains that it builds on delete routines from the Terraform AWS provider, list operations from the author's awsls project, and generated code based on AWS API models.

By the documented v0.12.0 release in February 2022, the README described support for more than 290 AWS resource types, with a stated goal of covering every AWS resource supported by Terraform without maintaining large amounts of bespoke deletion code in AWSweeper itself.

### Adoption history

AWSweeper's official README documents installation from GitHub releases and from the author's Homebrew tap. The batch input also shows packaging in Homebrew and Nix, which is typical for a niche infrastructure CLI: small enough to remain specialized, but useful enough to be packaged for repeatable workstation and CI installation.

### How it is used

Users pass AWSweeper a YAML filter file naming Terraform-style AWS resource type identifiers and optional filters by id, tag, or creation date. The tool lists matching resources before deletion, supports a dry-run mode, and requires explicit confirmation unless the dangerous force flag is used for automation.

### Why package nerds care

Package maintainers care about AWSweeper because it is a compact example of a cloud CLI that delegates hard provider-specific behavior to generated AWS and Terraform-adjacent code. It is also exactly the kind of tool package managers make safer to install: operationally powerful, infrequently used, and much better pinned to a known release than fetched from an arbitrary install script.

### Timeline

- 2017: Official GitHub repository created.
- 2017: v0.1.0 GitHub release published.
- 2020: Regular v0.5 through v0.11 release series.
- 2022: v0.12.0 release published.

### Related projects

- The README explicitly relates AWSweeper to the Terraform AWS provider for delete routines, awsls for list operations, AWS SDK API models for generated code, and awsrm as a later Unix-like AWS resource deletion tool by the same author.

### Sources

- GitHub releases API lists v0.1.0 on 2017-11-22 and v0.12.0 on 2022-02-08.
- GitHub repository metadata: created_at 2017-07-25.
- Official README documents resource coverage, Terraform provider relationship, awsls relationship, install methods, and usage.
- input.source_facts.package-manager lists Homebrew and Nix packaging.


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** awsweeper
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - awsweeper: normalized package name match | nixpkgs package indexes: pkgs/by-name/aw/awsweeper/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control 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.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [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.
- [aws-iam-authenticator](https://www.automicvault.com/pkg/brew/aws-iam-authenticator/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure.
- [aws-rotate-key](https://www.automicvault.com/pkg/brew/aws-rotate-key/) - Local package facts share a topical domain. Shared terms: aws, cli, cloud, cloud-infrastructure, infrastructure.
- [kubetrim](https://www.automicvault.com/pkg/brew/kubetrim/) - Local package facts share a topical domain. Shared terms: cleanup, cli, cloud, cloud-infrastructure, infrastructure.
- [terraform-cleaner](https://www.automicvault.com/pkg/brew/terraform-cleaner/) - Local package facts share a topical domain. Shared terms: cleanup, cli, cloud, cloud-infrastructure, infrastructure.

## Combined YAML source

View the package source record on GitHub. [combined/awsweeper.yml](https://github.com/automic-vault/db/blob/main/combined/awsweeper.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
