Installation Guide#

Prerequisites#

Dirvana works with:

  • Bash (4.0+)
  • Zsh (5.0+)
  • Linux, macOS, or WSL

If you use aqua, add this to your aqua.yaml:

registries:
- type: standard
  ref: v4.223.0 # renovate: depName=aquaproj/aqua-registry

packages:
  - name: NikitaCOEUR/dirvana@vX.Y.Z  # replace X.Y.Z with the desired version

Then run:

aqua install --link-only

Method 2: Using go install#

If you have Go installed (1.21+):

go install github.com/NikitaCOEUR/dirvana/cmd/dirvana@latest

Method 3: Download Binary#

Linux#

curl -L https://github.com/NikitaCOEUR/dirvana/releases/latest/download/dirvana-linux-amd64 -o /usr/local/bin/dirvana
chmod +x /usr/local/bin/dirvana

For ARM64:

curl -L https://github.com/NikitaCOEUR/dirvana/releases/latest/download/dirvana-linux-arm64 -o /usr/local/bin/dirvana
chmod +x /usr/local/bin/dirvana

macOS#

Intel:

curl -L https://github.com/NikitaCOEUR/dirvana/releases/latest/download/dirvana-darwin-amd64 -o /usr/local/bin/dirvana
chmod +x /usr/local/bin/dirvana

Apple Silicon (M1/M2):

curl -L https://github.com/NikitaCOEUR/dirvana/releases/latest/download/dirvana-darwin-arm64 -o /usr/local/bin/dirvana
chmod +x /usr/local/bin/dirvana

Setup Shell Hook#

This step is required for automatic environment loading!

Run the setup command:

dirvana setup

This will:

  • Detect your shell (Bash or Zsh)
  • Add a hook to your ~/.bashrc or ~/.zshrc
  • Enable automatic configuration loading on directory changes
  • Install shell completion

Reload your shell:

source ~/.bashrc  # For Bash
source ~/.zshrc   # For Zsh

Or simply restart your terminal.

Verify Installation#

Check that Dirvana is installed correctly:

dirvana version

You should see the version information.

Shell Completion#

The dirvana setup command automatically installs shell completion. If you need to install it manually:

Bash:

# One-time use (current shell only)
source <(dirvana completion bash)

# Permanent
dirvana completion bash > ~/.bash_completion.d/dirvana

Zsh:

# One-time use (current shell only)
source <(dirvana completion zsh)

# Permanent
dirvana completion zsh > "${fpath[1]}/_dirvana"
# Then reload: compinit

Next Steps#

Quick Start →
Quick Start Forward