Repolode
aws

aws/aws-cli

Official unified command line interface for managing Amazon Web Services from a terminal or scripts.

Stars
17,343
Forks
4,751
Open issues
767
Last commit
20 hours ago

What is it?

AWS CLI is the official command line tool for Amazon Web Services. It gives a single `aws` command that calls AWS service APIs, so you can create, inspect and change cloud resources from a shell instead of the web console.

Credentials can come from environment variables, shared credentials and config files with named profiles, or IAM roles on EC2 instances. Output defaults to JSON and can be filtered with the `--query` option using JMESPath expressions, or shown as an ASCII table. The package also provides bash, tcsh and zsh command completion, and a development branch for contributors.

The current major version is v2, distributed as installers for macOS, Linux (x86-64 and arm64) and Windows, and as a Python package supporting Python 3.9 through 3.14.

Key features

  • 01Calls AWS service APIs from a single `aws` command.
  • 02Supports environment variables, shared credential files, named profiles and IAM roles.
  • 03Reads large or complex parameters from JSON files using the `file://` prefix.
  • 04Filters JSON output with `--query` and can print ASCII tables.
  • 05Provides tab completion for bash, tcsh and zsh.

Use cases

  • Automating AWS resource management in shell scripts or CI pipelines.
  • Querying EC2, S3 or IAM state from a terminal without the web console.
  • Managing multiple AWS accounts or regions through named profiles.

Quick start

  1. 1

    Download the official installer for your platform from the README links

  2. 2

    Configure your AWS credentials and default region

    aws configure
  3. 3

    Run a test command such as listing IAM users

    aws iam list-users

Things to know

  • You need AWS credentials and an AWS account to use most commands.
  • The metadata gives no clear license, so check the license terms before reuse.

In collections

Topics

FAQ

What is aws-cli?
Official unified command line interface for managing Amazon Web Services from a terminal or scripts. AWS CLI is the official command line tool for Amazon Web Services. It gives a single `aws` command that calls AWS service APIs, so you can create, inspect and change cloud resources from a shell instead of the web console.
Is aws-cli free to use? What license does it have?
aws-cli is open source under the Other license. Check the license terms before using it in commercial products.
Is aws-cli still maintained?
Actively maintained. The last commit to aws-cli was on Nov 6, 2026.
What can I use aws-cli for?
Automating AWS resource management in shell scripts or CI pipelines. Querying EC2, S3 or IAM state from a terminal without the web console. Managing multiple AWS accounts or regions through named profiles.
How do I install aws-cli?
Download the official installer for your platform from the README links Configure your AWS credentials and default region: aws configure Run a test command such as listing IAM users: aws iam list-users
Where can I get aws-cli?
The source code and installation instructions are on GitHub: https://github.com/aws/aws-cli

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects