Hibiscus is a modern, terminal-based user interface (UI) that helps you interact with your AWS resources with ease. Built with a focus on simplicity and efficiency, Hibiscus provides a streamlined experience for managing your cloud infrastructure from the comfort of your terminal. The interface is powered by tview for instant redraws, rich tables, and modal workflows.
- Intuitive Navigation: Quickly navigate through your AWS services and resources using an intuitive, keyboard-driven interface.
- Real-time Updates: Stay up-to-date with the latest changes in your AWS environment, with Hibiscus continuously refreshing your view.
- Detailed Information: Dive into your AWS resources, including ECR and Route53, and more.
- Seamless Integration: Hibiscus integrates seamlessly with the AWS CLI, allowing you to leverage existing tools and scripts.
- Responsive Design: The UI adapts to different terminals, ensuring a consistent across devices.
Hibiscus can be installed using the popular package manager, Homebrew:
brew update
brew install jaehong21/tap/hibiscusAlternatively, you can download the latest release from the GitHub Releases page and install it manually.
To start using Hibiscus, simply run the following command in your terminal:
# add alias for convenience at your shell config (optional)
# alias hb='hibiscus'
hibiscus # using 'default' AWS CLI profile
hibiscus --profile prod # with AWS CLI profile:– open the command palette and jump toecr,route53, orelb/– focus the active view's filter (repositories, hosted zones, load balancers)Enter– drill down one level (repo → images, zone → records, load balancer → listeners → rules)Esc– back out of the current level or exit filter modeR– refresh the active viewe/Ctrl+D(Route53 records) – edit the selected record's type/value/TTL or confirm deletion before removing itCtrl+C– quit the application
Hibiscus automatically saves your last used service tab (ECR, Route53, ELB, etc.) between sessions, so you can pick up right where you left off.
The configuration file is stored following XDG standards:
- If
XDG_CONFIG_HOMEis set:$XDG_CONFIG_HOME/hibiscus/config.yaml - Otherwise:
$HOME/.config/hibiscus/config.yaml
The configuration file is created automatically the first time you use Hibiscus and is updated whenever you switch between services.
The configuration file is a simple YAML file that stores your preferences:
hibiscus:
service_name: ecr # The last service you were using (ecr, route53, elb)Note that AWS profile settings are NOT persisted and must be provided with the --profile flag for each session.
| Service Name | View | Edit | Description |
|---|---|---|---|
| Amazon ECR | ✓ | ✕ | Easily store, share, and deploy your container software anywhere |
| AWS ECR Public | ✕ | ✕ | Easily store, share, and deploy your container software anywhere in public |
| Amazon Route53 | ✓ | ✓ | Browse hosted zones and edit record type/value/TTL directly from the TUI |
| Amazon ELB | ✓ | ✕ | Distribute network traffic to improve application scalability |
| AWS SSM Parameter Store | ✕ | ✕ | Secure, hierarchical storage for configuration data management and secrets management |
We welcome contributions from the community! If you'd like to contribute to Hibiscus, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Implement your changes and write relevant tests.
- Submit a pull request, explaining the changes you've made.
If you have any questions or feedback, feel free to reach out to us:
- Email: [email protected]
- GitHub: @jaehong21
Let's make cloud management a breeze with Hibiscus!