https://github.com/with-heart/rerole

Menu wrapper for assume-role
https://github.com/with-heart/rerole

assume-role aws

Last synced: 5 months ago
JSON representation

Menu wrapper for assume-role

• Host: GitHub
• URL: https://github.com/with-heart/rerole
• Owner: with-heart
• Created: 2018-09-15T08:29:41.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-04T12:46:36.000Z (over 3 years ago)
• Last Synced: 2025-10-22T23:31:48.328Z (9 months ago)
• Topics: assume-role, aws
• Language: JavaScript
• Size: 614 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 11
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# rerole

> rerole is a menu wrapper for `assume-role`

![Screencap of rerole in action](screencap.gif)

## Installation

1. [Install assume-role][assume-role]

2. Globally install `@with-heart/rerole`:

```bash

$ npm i -g @with-heart/rerole

```

3. Use the `source` command found in the postinstall message or by running `rerole showCommand` (**note: rerole will not work if this step is not completed**)

## Usage

Use the `rerole` command to select your desired profile from a menu created from the profiles (and default, if it exists) found in your `~/.aws/config` file. This profile is then used to run the command `eval $(assume-role $selected_role)`, which is needed to add the `assume-role` environment variables to the current shell.

See the [`assume-role` readme][assume-role] for more information.

## Explanation

_Coming soon_

[assume-role]: https://github.com/remind101/assume-role