https://github.com/suonto/awsp-zsh-plugin

Improvement of the official ZSH AWS Plugin. Adds colors and intuitive profile management.
https://github.com/suonto/awsp-zsh-plugin

Last synced: about 1 month ago
JSON representation

Improvement of the official ZSH AWS Plugin. Adds colors and intuitive profile management.

• Host: GitHub
• URL: https://github.com/suonto/awsp-zsh-plugin
• Owner: suonto
• License: mit
• Created: 2022-01-18T10:18:21.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-12-03T17:14:17.000Z (about 2 months ago)
• Last Synced: 2024-12-03T18:24:29.323Z (about 2 months ago)
• Language: Shell
• Size: 185 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• trackawesomelist - awsp (⭐0) - AWS profile management for ZSH. Inspired by oh-my-zsh's [aws (⭐174k)](https://github.com/ohmyzsh/ohmyzsh/blob/master/plugins/aws/aws.plugin.zsh) plugin. (Recently Updated / [Dec 06, 2024](/content/2024/12/06/README.md))

README

        
# awsp

AWS profile management plugin for ZSH.

Inspired by https://github.com/ohmyzsh/ohmyzsh/blob/master/plugins/aws/aws.plugin.zsh.

Improvements: colors, intuitive usage.

## Installation

```

git clone [email protected]:suonto/awsp-zsh-plugin.git ~/.oh-my-zsh/custom/plugins/awsp

```

Modify `~/.zshrc` plugins to include `awsp`. Open a new shell.

You can optimize perf by adding also `source $HOME/.oh-my-zsh/custom/plugins/awsp/awsp_colors.sh`.

## Configuration

```

cp ~/.oh-my-zsh/custom/plugins/awsp/awsp_colors.default.sh ~/.oh-my-zsh/custom/plugins/awsp/awsp_colors.sh

vi ~/.oh-my-zsh/custom/plugins/awsp/awsp_colors.sh

```

Note: color matching currently supports wildcard (*) only as the last character.

## Usage

```

% awsp --help

Usage: awsp [OPTIONS] [PROFILE]

An intuitive aws profile manager.

Reads profile data from ~/.aws/config.

Options:

  -h, --help    Get help

  -d, --disable Remove aws profile information from RPROMPT

Set AWSP_RPOMPT_OPT_OUT to any non-empty value to permanently opt

out of RPROMPT info.

```

### Features

List by default:

![default](pics/default.png)

Autocomplete:

![autocomplete](pics/autocomplete.png)

Colors:

![colors](pics/colors.png)

Mistake detection:

![errors](pics/errors.png)

#### Extension awsps (aws profile show)

Shows all details of the current aws profile.