A beautiful TUI (Terminal User Interface) for viewing AWS Secrets Manager secrets and SSM Parameter Store parameters, built with Go and Bubble Tea.
- Beautiful TUI: Built with Charm's Bubble Tea framework for a polished terminal experience
- Two sources, one app: Browse AWS Secrets Manager secrets and SSM Parameter Store parameters, and switch between them instantly with
tab. The whole UI recolours as a mode signal — pink for Secrets Manager, fluoro green for SSM. The last-used source is remembered between launches. - Shared credentials: Both sources reuse the same profile, region, and MFA/role-assumption setup
- On-Demand Fetching: Values are only fetched (and SecureString parameters decrypted) when you explicitly request them (security-first)
- Clipboard Support: Copy full values as plain text; for JSON secrets, copy as formatted JSON or copy an individual top-level field
- Profile & Region Switching: Easily switch between AWS profiles and regions
- Pagination: Handles large numbers of secrets/parameters with built-in pagination
- Go 1.21 or later
make(for the convenience targets below)- AWS credentials configured (via
aws configureor environment variables) - Required IAM permissions (see below)
# Clone the repository
git clone https://github.com/benjamingriff/secretsrc.git
cd secretsrc
# Show available tasks
make help
# Run the app directly from source
make run
# Run the test suite
make test
# Build a local binary in the repo root
make build
./secretsrccd /path/to/secretsrc
make installmake install runs go install ./cmd/secretsrc, which installs secretsrc into:
$(go env GOBIN)ifGOBINis set- otherwise
$(go env GOPATH)/bin
If secretsrc is not directly runnable after install, add your Go bin directory to your PATH.
For zsh, if GOBIN is not set, this is the usual setup:
echo 'export PATH="$(go env GOPATH)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcYou can then confirm the install with:
command -v secretsrc
secretsrcIf you want to install the latest published version directly from Go without building from your checkout:
go install github.com/benjamingriff/secretsrc/cmd/secretsrc@latestcd /path/to/secretsrc
git pull --ff-only
make installIf you have local uncommitted changes in the repo, either commit them, stash them, or reapply them after pulling before you reinstall.
go install github.com/benjamingriff/secretsrc/cmd/secretsrc@latestThat fetches the latest version again and replaces the installed secretsrc binary in your Go bin directory.
Secret Src uses the same credential chain as the AWS CLI:
- Environment variables (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY) - Shared credentials file (
~/.aws/credentials) - Shared config file (
~/.aws/config)
To set up credentials:
aws configureYou can also use the AWS_PROFILE and AWS_REGION environment variables to override defaults:
export AWS_PROFILE=myprofile
export AWS_REGION=us-west-2
./secretsrcIf you do not set AWS_REGION, Secret Src will let the AWS SDK resolve the region from your shared AWS config for the selected profile.
Your AWS user or role needs the following permissions:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:ListSecrets",
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:DescribeParameters",
"ssm:GetParameter"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": "*"
}
]
}Notes:
- The
ssm:*permissions are only needed if you use the SSM Parameter Store view (tabto switch to it). - The
kms:Decryptpermission is needed to read secrets encrypted with custom KMS keys and to decryptSecureStringparameters. If you don't have it, listing still works (metadata only), but viewing aSecureStringvalue returns an access-denied error.
↑/k- Move up↓/j- Move down←/h- Move left→/l- Move rightenter- View detailstab- Switch source between Secrets Manager (pink) and SSM Parameter Store (green)/- Start filtering by nameesc- Clear the active filter when filtering, otherwise quitspace/pgdn- Move to the next grid screenpgup- Move to the previous grid screenp- Switch AWS profileg- Switch AWS regionr- Refresh the listn- Load next AWS page (when available)b- Load previous AWS page?- Toggle helpq- Quit
tab works from any screen and returns you to the list in the new source.
v- View the value (decrypt and display;SecureStringparameters are decrypted on fetch)c- Copy the value to clipboard (plain text)j- Copy the value as formatted JSON (Secrets Manager only)k- Copy a top-level JSON field from the loaded secret (Secrets Manager only)esc/q- Back to the listctrl+c- Force quit
SSM parameters are treated as plain strings, so the detail screen offers only
vandc— there is no JSON field picker.
↑/k- Move up in list↓/j- Move down in listenter- Select profile/region and switchesc/q- Cancel and go back/- Filter/search (built-in)
- Browse: Launch the app to see a list of all secrets (or parameters) in your current AWS region
- Switch Source: Press
tabto flip between Secrets Manager and SSM Parameter Store — the UI recolours to tell you which one you're in - Switch Profile/Region: Press
pto select a different AWS profile orgto select a different region (shared across both sources) - View Details: Press
enteron an item to see its metadata (name, ARN, last modified date; plus type and version for parameters) - Fetch Value: Press
vto fetch the value on-demand (SecureStringparameters are decrypted at this point) - Copy to Clipboard: Press
cfor plain text. For JSON secrets, pressjfor a JSON-formatted copy orkto choose a top-level field
- On-Demand Fetching: Values are never automatically fetched or displayed. You must explicitly press
vto decrypt them. Listing (both secrets and parameters) returns metadata only — never values. - Memory Clearing: Values are cleared from memory when you navigate away from the detail screen or switch source with
tab. - Alternate Screen: The app uses the terminal's alternate screen buffer, so secrets don't remain in scrollback history.
- Clipboard Persistence: Be aware that copied secrets will remain in your clipboard after the app closes. Clear your clipboard if needed.
secretsrc/
├── cmd/
│ └── secretsrc/
│ └── main.go # Application entry point
├── pkg/
│ ├── aws/
│ │ ├── client.go # AWS client initialization (Secrets Manager + SSM)
│ │ ├── secrets.go # Secrets Manager operations
│ │ ├── parameters.go # SSM Parameter Store operations
│ │ └── config.go # Profile/region management
│ ├── models/
│ │ └── entry.go # Shared Entry data structure (secrets + parameters)
│ └── ui/
│ ├── app.go # Main Bubble Tea model, mode toggle
│ ├── view.go # View rendering (mode-aware colours)
│ ├── keys.go # Key bindings
│ ├── styles.go # Lipgloss styles + accent colours
│ └── components/
│ ├── grid.go # Entry grid component
│ ├── profile_selector.go # Profile selection
│ └── region_selector.go # Region selection
├── go.mod
├── go.sum
└── README.md
- Run
aws configureto set up your credentials - Or set
AWS_ACCESS_KEY_IDandAWS_SECRET_ACCESS_KEYenvironment variables
- Ensure your AWS user/role has the required IAM permissions (see above) — note the separate
ssm:*actions for the Parameter Store view - Check that you're using the correct AWS profile
- Reading a
SecureStringvalue decrypts it, which requireskms:Decrypton the parameter's KMS key. Listing still works without it.
- Verify that the items exist in the current AWS profile and region via the AWS Console or CLI
- If you rely on profile-specific regions, ensure the correct profile is selected or set
AWS_REGION - Remember you may just be in the other source — press
tabto switch
- The
atotto/clipboardlibrary requires X11 on Linux - Install
xcliporxsel:sudo apt-get install xclip
- List secrets with pagination
- View secret details
- On-demand secret value fetching
- Clipboard copy (plain text & JSON)
- Interactive profile selector
- Interactive region selector
- Search/filter secrets
- SSM Parameter Store support (toggle with
tab) - Secret versioning support
- Create/update/delete secrets
- Secret rotation status
- Export secrets to file
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details
- Built with Bubble Tea by Charm
- Styled with Lipgloss
- Uses Bubbles components
- AWS SDK for Go v2