asdf-vals

Vals plugin for the asdf version manager.

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
  • Contents
  • Dependencies
  • Install
    • Plugin
    • Vals
  • Environment Variables
  • Features
  • Contributing
    • Development
    • Testing Locally
    • Credits
  • License

Dependencies

Required:

• bash (3.2+), curl, tar, git
• POSIX utilities

Optional:

• sha256sum or shasum - For checksum verification
• df - For disk space checking

Install

Plugin

asdf plugin add vals
# or
asdf plugin add vals https://github.com/sgaunet/asdf-vals.git

Vals

# 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 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.

Development

This project uses Task for automation:

# List available tasks
task

# Format code
task format

# Run linting
task lint

# Run tests
task test

Testing Locally

asdf plugin test <plugin-name> <plugin-url> [--asdf-tool-version <version>] [--asdf-plugin-gitref <git-ref>] [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!

License

See LICENSE