direnv

direnv [command] [arguments]

direnv is an environment switcher that loads and unloads environment variables based on the current directory. When you enter a directory containing an .envrc file, direnv automatically exports its variables into your shell. When you leave, it unloads them.The .envrc file is a bash script that typically sets environment variables using export. Direnv provides a standard library of functions for common tasks like setting PATH, loading .env files, using nix-shell, or activating Python virtual environments.For security, .envrc files must be explicitly allowed before they're executed. This prevents malicious code from running when entering untrusted directories. The allow command whitelists a file based on its content hash; any change requires re-approval.Integration requires adding a shell hook to your configuration (e.g., ~/.bashrc). The hook modifies the prompt to show when direnv is active and handles automatic loading/unloading. Direnv supports bash, zsh, fish, tcsh, elvish, and other shells.Common use cases include project-specific environment variables, automatic virtual environment activation, and development environment configuration.

allow [path]

Approve an .envrc file to be loaded. Security measure to prevent executing arbitrary code.

Revoke approval for an .envrc file.

Open .envrc in $EDITOR and allow it after editing.

Manually reload the current directory's environment.

Show direnv's current status and active .envrc.

Export the current environment for the specified shell (bash, zsh, fish, etc.).

Print the shell hook code to enable direnv.

Display the currently loaded .envrc file.

Print direnv version.

Remove old allowed file entries.

Fetch a URL with caching and optional integrity check.

Print the stdlib functions available in .envrc.

.envrc

Per-directory environment configuration script loaded when entering the directory.

Global direnv configuration for whitelist and settings.

Global shared functions and settings available to all .envrc files.

Shell hook must be added to config for automatic operation. .envrc files must be explicitly allowed (security feature). Changes to .envrc require re-allowing. Some shell features may not work identically in .envrc. Large environments may cause slight delay when changing directories.

direnv was created by Jonas Pfenniger (zimbatm) around 2013 to solve the problem of managing per-project environment configurations. It was inspired by the need to switch between different development environments without manually sourcing files. The tool has become popular in the DevOps and development communities, especially with nix integration.

env(1), export(1), nix-shell(1), virtualenv(1)