direnv/direnv

Health v2 · maintenance only

Adoption not part of the score

15498 stars · 823 forks observed · 2026-10-12

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

direnv is a shell extension that loads and unloads environment variables based on the current directory by evaluating an authorized .envrc (or .env) file. It is a single static Go binary that hooks into bash, zsh, fish, tcsh, and other shells to provide per-project environments without cluttering ~/.profile.

Use cases

• load project-specific environment variables when entering a directory
• manage 12factor app configuration per project
• load deployment secrets into the shell automatically
• create isolated per-project development environments like rbenv or pyenv
• reuse .envrc files in GitHub Actions CI pipelines
• stop duplicating environment setup in ~/.profile

When to choose

• you want directory-scoped environment variables that load and unload automatically
• you need per-project tool versions or secrets without editing your shell profile
• you want one language-agnostic tool shared across bash, zsh, fish, and other shells
• you want consistent env setup between local dev and CI

When to avoid

• you are on a purely Windows workflow without a Unix-like shell
• you need container-level or system-wide environment management rather than per-directory shell env
• your team cannot tolerate an explicit allow-list security step for each .envrc

Facets

cli-tool · maturity stable

configuration-management secrets-management developer-tools cli developer-tools windows cli cross-platform environment-variables shell-extension envrc dotenv per-project-environments shell-hook command-line automation devops linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="direnv/direnv")