aqua

Declarative CLI Version manager written in Go. Support Lazy Install, Registry, and continuous update with Renovate. CLI version is switched seamlessly

20 articles 1.5k View on GitHub ↗
20 articles
Performance Implications of Using Aqua: Caching, Concurrency, and Runtime Efficiency

Discover how Aqua optimizes performance with caching, concurrency, and lazy loading for sub-millisecond warm starts and efficient CI pipelines.

performance
Feb 25, 2026
How to Integrate aqua with CI/CD Pipelines: Complete GitHub Actions and CircleCI Guide

Easily integrate aqua with CI/CD pipelines using GitHub Actions and CircleCI. Install tools securely with automatic checksum verification and caching.

how-to-guide
Feb 25, 2026
How to Configure aqua.yaml for Custom Commands: A Complete Guide to Command Aliases

Learn to configure aqua.yaml for custom commands using command aliases. Aqua creates symbolic links so you can invoke aliases like native commands easily.

how-to-guide
Feb 25, 2026
What Is the Default Installation Directory for aqua? A Complete Guide

Discover the default installation directory for aqua on Unix and Windows systems. Learn how AQUA_ROOT_DIR overrides this location for precise control over your installations.

how-to-guide
Feb 25, 2026
How Aqua Manages Tool Versions: A Deep Dive into the Modular VersionGetter Pipeline

Learn how aqua manages tool versions using a modular VersionGetter pipeline that pulls from GitHub tags releases Cargo and Go modules and extracts semantic versions.

deep-dive
Feb 25, 2026
What Dependencies Does Aqua Manage? A Complete Guide to CLI Package Types

Discover the diverse dependencies aqua manages including GitHub releases archives HTTP downloads Go modules and Rust crates Install versioned binaries without compilation.

deep-dive
Feb 25, 2026
What Is the Role of runner.go in the Aqua Project?

Discover the role of runner.go in the Aqua project. Learn how it manages CLI execution, sets up tool environments, and handles installations for seamless command invocation.

internals
Feb 25, 2026
Where Is the Command Registration Logic in Aqua? A Deep Dive into the CLI Architecture

Discover where the command registration logic resides in Aqua's CLI architecture. We explore the runner go file and how commands are assembled for a full understanding of the CLI.

deep-dive
Feb 25, 2026
Main Entry Point for the Aqua CLI: A Deep Dive into cmd/aqua/main.go

Discover the main entry point for the aqua CLI in cmd/aqua/main.go. Understand how the application bootstraps and delegates execution to pkg/cli/runner.go for seamless operation.

deep-dive
Feb 25, 2026
How to Find Tool Installation Paths with aqua which: A Complete Guide

Find tool installation paths with aqua which. Learn how to resolve aqua-managed tool paths and fallback to system PATH for unmanaged binaries in this complete guide.

how-to-guide
Feb 25, 2026
What Is the aqua exec Command? Purpose and Implementation in Aqua

Discover the aqua exec command purpose. Learn how aqua exec installs and runs tools managed by Aqua for efficient project workflows.

deep-dive
Feb 25, 2026
How to Update Tools with the aqua update Command: A Complete Guide

Learn to update tools with the aqua update command in aquaproj. Refresh tool versions in aqua.yaml, select specific packages, or use interactive updates.

how-to-guide
Feb 25, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →