{"id":31073676,"url":"https://github.com/sgaunet/asdf-vals","last_synced_at":"2025-09-16T01:57:54.819Z","repository":{"id":314954446,"uuid":"1057462501","full_name":"sgaunet/asdf-vals","owner":"sgaunet","description":"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.","archived":false,"fork":false,"pushed_at":"2025-09-15T20:36:37.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-15T22:06:24.858Z","etag":null,"topics":["asdf","asdf-plugin","aws-secrets-manager","cli-tool","configuration","devops","gcp-secret-manager","helmfile","secrets-management","vals","vault"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sgaunet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-15T18:59:21.000Z","updated_at":"2025-09-15T20:54:22.000Z","dependencies_parsed_at":"2025-09-15T22:06:27.015Z","dependency_job_id":"aeef7667-f9f1-4ac7-89a5-86b0cdc46361","html_url":"https://github.com/sgaunet/asdf-vals","commit_stats":null,"previous_names":["sgaunet/asdf-vals"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sgaunet/asdf-vals","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgaunet%2Fasdf-vals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgaunet%2Fasdf-vals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgaunet%2Fasdf-vals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgaunet%2Fasdf-vals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sgaunet","download_url":"https://codeload.github.com/sgaunet/asdf-vals/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sgaunet%2Fasdf-vals/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275348504,"owners_count":25448626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-15T02:00:09.272Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asdf","asdf-plugin","aws-secrets-manager","cli-tool","configuration","devops","gcp-secret-manager","helmfile","secrets-management","vals","vault"],"created_at":"2025-09-16T01:57:51.273Z","updated_at":"2025-09-16T01:57:54.802Z","avatar_url":"https://github.com/sgaunet.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# asdf-vals\n\n[![Build](https://github.com/sgaunet/asdf-vals/actions/workflows/build.yml/badge.svg)](https://github.com/sgaunet/asdf-vals/actions/workflows/build.yml)\n[Vals](https://github.com/helmfile/vals) plugin for the [asdf version manager](https://asdf-vm.com).\n\nVals 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.\n\n## Contents\n\n- [asdf-vals](#asdf-vals)\n  - [Contents](#contents)\n  - [Dependencies](#dependencies)\n  - [Install](#install)\n    - [Plugin](#plugin)\n    - [Vals](#vals)\n  - [Environment Variables](#environment-variables)\n  - [Features](#features)\n  - [Contributing](#contributing)\n    - [Development](#development)\n    - [Testing Locally](#testing-locally)\n    - [Credits](#credits)\n  - [License](#license)\n\n## Dependencies\n\n**Required:**\n- `bash` (3.2+), `curl`, `tar`, `git`\n- [POSIX utilities](https://pubs.opengroup.org/onlinepubs/9699919799/idx/utilities.html)\n\n**Optional:**\n- `sha256sum` or `shasum` - For checksum verification\n- `df` - For disk space checking\n\n## Install\n\n### Plugin\n\n```shell\nasdf plugin add vals\n# or\nasdf plugin add vals https://github.com/sgaunet/asdf-vals.git\n```\n\n### Vals\n\n```shell\n# Show all installable versions\nasdf list-all vals\n\n# Install specific version\nasdf install vals latest\n\n# Set a version globally (on your ~/.tool-versions file)\nasdf global vals latest\n\n# Now vals commands are available\nvals version\n\n# Get help\nasdf help vals\n```\n\nCheck the [asdf documentation](https://asdf-vm.com/guide/getting-started.html) for more instructions on how to install \u0026 manage versions.\n\n## Environment Variables\n\nThe plugin supports several environment variables for customization:\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `ASDF_VALS_DEBUG` | `0` | Enable debug output for troubleshooting |\n| `ASDF_VALS_MAX_RETRIES` | `3` | Maximum retry attempts for network operations |\n| `ASDF_VALS_RETRY_DELAY` | `2` | Delay in seconds between retries |\n| `GITHUB_API_TOKEN` | - | GitHub token for higher API rate limits |\n\n## Features\n\n- ✅ **Automatic retries** - Network operations are retried on failure\n- ✅ **Checksum verification** - Downloads are verified when checksums are available\n- ✅ **Progress indicators** - Visual feedback during downloads\n- ✅ **Debug mode** - Detailed logging for troubleshooting\n- ✅ **Platform detection** - Automatic detection of OS and architecture\n- ✅ **Disk space checking** - Verifies available space before installation\n- ✅ **Multi-platform support** - Linux, macOS, Windows (WSL), BSD variants\n- ✅ **Architecture support** - amd64, arm64, 386, arm\n\n## Contributing\n\nContributions of any kind are welcome! See the [contributing guide](CONTRIBUTING.md).\n\n### Development\n\nThis project uses Task for automation:\n\n```shell\n# List available tasks\ntask\n\n# Format code\ntask format\n\n# Run linting\ntask lint\n\n# Run tests\ntask test\n```\n\n### Testing Locally\n\n```shell\nasdf plugin test \u003cplugin-name\u003e \u003cplugin-url\u003e [--asdf-tool-version \u003cversion\u003e] [--asdf-plugin-gitref \u003cgit-ref\u003e] [test-command*]\n\nasdf plugin test vals https://github.com/sgaunet/asdf-vals \"vals version\"\n```\n\nTests are automatically run in GitHub Actions on push and PR.\n\n### Credits\n\n[Thanks goes to these contributors](https://github.com/sgaunet/asdf-vals/graphs/contributors)!\n\n## License\n\nSee [LICENSE](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgaunet%2Fasdf-vals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsgaunet%2Fasdf-vals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsgaunet%2Fasdf-vals/lists"}