https://github.com/sgaunet/asdf-vals
ASDF plugin for Vals - a tool for managing configuration values and secrets from multiple sources including Vault, AWS Secrets Manager, GCP Secret Manager, and more. Supports cross-platform installation and version management.
https://github.com/sgaunet/asdf-vals
asdf asdf-plugin aws-secrets-manager cli-tool configuration devops gcp-secret-manager helmfile secrets-management vals vault
Last synced: 18 days ago
JSON representation
ASDF plugin for Vals - a tool for managing configuration values and secrets from multiple sources including Vault, AWS Secrets Manager, GCP Secret Manager, and more. Supports cross-platform installation and version management.
- Host: GitHub
- URL: https://github.com/sgaunet/asdf-vals
- Owner: sgaunet
- License: mit
- Created: 2025-09-15T18:59:21.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2025-09-15T20:36:37.000Z (19 days ago)
- Last Synced: 2025-09-15T22:06:24.858Z (18 days ago)
- Topics: asdf, asdf-plugin, aws-secrets-manager, cli-tool, configuration, devops, gcp-secret-manager, helmfile, secrets-management, vals, vault
- Language: Shell
- Size: 16.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# asdf-vals
[](https://github.com/sgaunet/asdf-vals/actions/workflows/build.yml)
[Vals](https://github.com/helmfile/vals) plugin for the [asdf version manager](https://asdf-vm.com).
Vals is a tool for managing configuration values and secrets from multiple sources including AWS SSM Parameter Store, AWS Secrets Manager, AWS S3, GCP Secrets Manager, Azure Key Vault, Hashicorp Vault, SOPS, Terraform State, and more.
## Contents
- [asdf-vals](#asdf-vals)
- [Contents](#contents)
- [Dependencies](#dependencies)
- [Install](#install)
- [Plugin](#plugin)
- [Vals](#vals)
- [Environment Variables](#environment-variables)
- [Features](#features)
- [Contributing](#contributing)
- [Development](#development)
- [Testing Locally](#testing-locally)
- [Credits](#credits)
- [License](#license)
## Dependencies
**Required:**
- `bash` (3.2+), `curl`, `tar`, `git`
- [POSIX utilities](https://pubs.opengroup.org/onlinepubs/9699919799/idx/utilities.html)
**Optional:**
- `sha256sum` or `shasum` - For checksum verification
- `df` - For disk space checking
## Install
### Plugin
```shell
asdf plugin add vals
# or
asdf plugin add vals https://github.com/sgaunet/asdf-vals.git
```
### Vals
```shell
# Show all installable versions
asdf list-all vals
# Install specific version
asdf install vals latest
# Set a version globally (on your ~/.tool-versions file)
asdf global vals latest
# Now vals commands are available
vals version
# Get help
asdf help vals
```
Check the [asdf documentation](https://asdf-vm.com/guide/getting-started.html) for more instructions on how to install & manage versions.
## Environment Variables
The plugin supports several environment variables for customization:
| Variable | Default | Description |
|----------|---------|-------------|
| `ASDF_VALS_DEBUG` | `0` | Enable debug output for troubleshooting |
| `ASDF_VALS_MAX_RETRIES` | `3` | Maximum retry attempts for network operations |
| `ASDF_VALS_RETRY_DELAY` | `2` | Delay in seconds between retries |
| `GITHUB_API_TOKEN` | - | GitHub token for higher API rate limits |
## Features
- ✅ **Automatic retries** - Network operations are retried on failure
- ✅ **Checksum verification** - Downloads are verified when checksums are available
- ✅ **Progress indicators** - Visual feedback during downloads
- ✅ **Debug mode** - Detailed logging for troubleshooting
- ✅ **Platform detection** - Automatic detection of OS and architecture
- ✅ **Disk space checking** - Verifies available space before installation
- ✅ **Multi-platform support** - Linux, macOS, Windows (WSL), BSD variants
- ✅ **Architecture support** - amd64, arm64, 386, arm
## Contributing
Contributions of any kind are welcome! See the [contributing guide](CONTRIBUTING.md).
### Development
This project uses Task for automation:
```shell
# List available tasks
task
# Format code
task format
# Run linting
task lint
# Run tests
task test
```
### Testing Locally
```shell
asdf plugin test [--asdf-tool-version ] [--asdf-plugin-gitref ] [test-command*]
asdf plugin test vals https://github.com/sgaunet/asdf-vals "vals version"
```
Tests are automatically run in GitHub Actions on push and PR.
### Credits
[Thanks goes to these contributors](https://github.com/sgaunet/asdf-vals/graphs/contributors)!
## License
See [LICENSE](LICENSE)