unic is a Go-based TUI (Terminal User Interface) tool for browsing and managing AWS resources in the terminal.
It manages authentication contexts (SSO or STS AssumeRole) via ~/.config/unic/config.yaml and provides drill-down exploration of AWS services registered in the catalog.
- Go (1.22+)
- TUI: Bubbletea + Lipgloss + Bubbles
- CLI: Cobra
- AWS SDK: aws-sdk-go-v2
- Config: gopkg.in/yaml.v3
- Concurrency: goroutines + errgroup
- Error handling: fmt.Errorf / errors
git clone <repository-url>
go build -o unic ./cmd/unic# Enter TUI mode
unic
# Specify profile/region
unic --profile my-profile
unic --region ap-northeast-2
# Initialize config file
unic init # Create default config
unic init --force # Overwrite existing config~/.config/unic/config.yaml (created via unic init or auto-generated on first run)
# Simple format
default_profile: my-profile
default_region: ap-northeast-2# Context-based format
current: dev-sso
contexts:
- name: dev-sso
profile: dev-sso
region: ap-northeast-2
- name: prod-admin
profile: prod-admin
region: us-east-1Priority: CLI flags (--profile, --region) > context settings > config defaults > hardcoded defaults (us-east-1)
| Service | Feature | Status |
|---|---|---|
| EC2 | SSM Session Manager (connect to EC2 instances) | ✅ Implemented |
| VPC | VPC Browser (VPCs → subnets → available IPs) | ✅ Implemented |
| RDS | RDS Browser (list, start/stop, failover, Aurora cluster support) | ✅ Implemented |
| Route53 | ListHostedZones | 🚧 Coming Soon |
| IAM | ListUsers | 🚧 Coming Soon |
| Key | Action |
|---|---|
j/k or ↑/↓ |
Navigate |
Enter |
Select |
Esc/q |
Go back |
H |
Go to home (service list) |
/ |
Filter (instances, IPs) |
C |
Context switcher |
s/x/f |
Start/Stop/Failover (RDS detail) |
q (on service list) |
Quit |
This project is licensed under the terms in LICENSE.
Comment on any issue to interact with @unic-bot:
| Command | Action |
|---|---|
@unic-bot: assign me |
Assign the issue to yourself |
- Code of Conduct: CODE_OF_CONDUCT.md
- Contributing Guide: CONTRIBUTING.md
- Security Policy: SECURITY.md
- Add maintainers here.