direnv

direnv. Loads and unloads per-directory environment variables when you cd into a project (via a hook in bash/zsh/fish).

Blurb

unclutter your .profile

Summary

What it does: reads .envrc in the project root (bash-like DSL), exports vars for that directory tree, reverts when you leave. Common patterns:

• dotenv / dotenv_if_exists: load .env (keep .env gitignored, commit .envrc)
• layout python, layout go: wire language version managers
• use nix, use flake: enter Nix dev shells on cd

When to assess / adopt locally:

• Many repos on the laptop with different PATH, API keys, or tool versions
• cursor-agent / CLI agents that expect .env loaded automatically (see vault agent-skills README)
• Polyglot monorepos where each subdirectory needs its own env

When to skip:

• Primary dev is Dev Container or remote environments (env is in the image)
• Team policy forbids shell hooks on corporate laptops
• You only need one global profile (use shell profile or a single version manager instead)

Security: run direnv allow only after reviewing .envrc; treat untrusted clones like arbitrary shell scripts.

Details

References

• direnv documentation