Chctx – omz plugin for changing context of AWS/Terraform

chctx is an Oh My Zsh plugin that simplifies context switching between AWS and Terraform. It offers automatic AWS SSO login, automatic profile switching using a .awsprofile file, and links of terraform workspace/folders to profiles

• Profile Selector: Quickly switch AWS profiles via an interactive menu or command argument.
• Automatic AWS SSO login: Automatically login to SSO based on the profile selected. (work only if configured with ~/.aws/config)
• Terraform Context: Automatically set Terraform working directories per AWS profile.
• Auto Profile Switching: Instantly switch profiles when entering directories containing a .awsprofile file.

1. Clone or copy the plugin into your Oh My Zsh plugins directory.
2. Add aws and chctx to the plugins array in your .zshrc:

3. Reload your shell:

• chctx: Switch to an AWS profile with autologin to sso and link to terraform path (if exists).
• lsctx: Opens a menu to select an AWS profile/Terraform path (if exists).
• shctx: Displays the current AWS profile and Terraform directory.

Edit your ~/.zshrc_priv (or similar private config file):

• Terraform Path:
  Use the environment variable TFPATH_<profile> (replace <profile> with your AWS profile name, removing any dashes; for example, profile-1 becomes profile1) to specify the Terraform directory for each profile.

• Auto Profile Switching:
  Place a .awsprofile file containing the profile name in any directory. When you cd or open a terminal into that directory, chctx will automatically switch to the specified profile.

  echo "profile1" > ~/Documents/terraform-project/profile1/.awsprofile

Contributions and feedback welcome!