This plugin aim is to integrate Direnv and Vim. Because Vim can shell out to other tools it's nice if the environment is in sync with the usual shell.

It also adds syntax highlighting for .envrc files.

• Direnv environment loading
• filetype & syntax highlighting for .envrc files
• Asynchronous running of Direnv command which won't delay your workflow. Supported in Vim 8 (with job and channel) or NeoVim.

The Vimscript syntax seems to limit keys to alphanumeric characters. If any environment variable key is something different the plugin might fail.

The newer Vim builds (>8.0.1459) & NeoVim have auto command event that is fired on directory changes, named: DirChanged. Thanks to that Direnv will be fired only on VimEnter (as entering Vim isn't directory change) and on DirChanged.

For older Vim's there is fallback that run on each BufEnter (not ideal solution, but for now we have no other option).

Due to asynchronous calls to Direnv if you work too fast then it can happen that variables from .envrc will not be yet loaded. However highly unlikely you are so fast.

Then install the plugin. With Pathogen

git clone https://github.com/direnv/direnv.vim.git ~/.vim/bundle/direnv.vim

and restart.

• Allow/deny authorization mechanism.
• Add proper Vim documentation.

My Vimscript skill is tangent to zero, feedback is welcome https://github.com/direnv/direnv.vim