aqua

Document | Contributing | Logo | Scorecard

Declarative CLI Version Manager written in Go.

• Switch tool versions per project
• Unify tool versions and how to install in your teams and CI
• Continuous update by Renovate
• Lazy Install
• Ecosystem by Registry
• Secure
• Easy to use

Who uses aqua?

Note

If you want to add your company, organization, project to the list, please send a pull request or send a comment to the GitHub Discussion!

• GitHub Public repositories that use aqua
• tfaction uses aqua heavily to install various tools such as Terraform, tfsec, tflint, tfcmt, and so on
• Recruit Co., Ltd. - StudySapuri and Quipper product team
• Masterpoint Consulting (ref)
• Retty (ref)
• Mercari, Inc.
• Gunosy Inc. (ref)
• DeNA Co., Ltd.
• CADDi Inc.
• Studist (ref)
• Connehito Inc. (ref)
• LayerX Inc. (ref)
• Cybozu, Inc. (ref)

License

MIT

About the license of logo, please see here.

---

Summary

Declarative CLI version manager in Go (1.9k stars, aquaproj; aquaproj.github.io): version-pinned tools via aqua.yaml, lazy install on first invocation, huge registry, Renovate-driven continuous updates. The predecessor inspiration both for mise’s registry and its declarative config style.

Learnings

• The daily-driver version manager here (user preference); mise borrowed its declarative model and registry approach, then added asdf-compatible shims, env vars, and task running. aqua-registry (aquaproj/aqua-registry, the shared Standard Registry) is the dataset mise relied on for years — and its author now co-builds packslip with jdx.

Gotchas

• (none yet)

Hands-on

(in active daily use)