Skip to content
zsh plugin that lets you use zsh in nix-shell shell.
Branch: master
Clone or download
Latest commit a65382a Dec 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github issue template Jun 13, 2018
scripts add shebang to shim Oct 31, 2019
.gitignore fixed rcfile Feb 4, 2018
LICENSE Create LICENSE Feb 2, 2018
README.MD added MacOS info Dec 20, 2019
nix-shell.plugin.zsh Fix NIX_SHELL_PACKAGES with multiple -p arguments Aug 21, 2018


zsh in nix-shell

This oh-my-zsh plugin lets you use zsh as the default shell in a nix-shell environment. It's recommended to use this in conjunction with nix-zsh-completions.


In theory all you need to do to use zsh in nix-shell is to set NIX_BUILD_SHELL to zsh. Unfortunatly nix assumes that the NIX_BUILD_SHELL is a bash variant and passes bash specific arguments to the shell. To fix this we need a shim that translates these arguments.

The information that nix-shell exposes to the environment is also pretty sparse. It would be nice to know what derivations are included in the current environment for example to display them in the shells prompt.



git clone $ZSH_CUSTOM/plugins/nix-shell

Then add nix-shell to the plugins list in ~/.zshrc.

Plain ZSH

Clone this repository and add the following to your ~/.zshrc.

source /path/to/zsh-nix-shell/nix-shell.plugin.zsh

Plugin managers

It should be possible to install this plugin through most zsh plugin managers. If the one of your choice is not supported feel free to open an issue or even better create a pull request.


On MacOS you have to have an bash with version 4 or greater. See Issue 14


Use nix-shell as you did before.

Commands run with --run or --command argument are executed in nix-shells default shell. In the case of --command you are put into a zsh shell afterwords.


If you use the --pure flag the interactive shell will be the default shell.

Environment info

If you are inside a nix-shell environment IN_NIX_SHELL will be set. The value will be impure or pure if you specified --pure.

The packages argument is passed through as NIX_SHELL_PACKAGES to the shell.

If this Variable is empty nix-shell was called for a specific nix expression which is stored in the name environment variable.

These variables can now be used inside a theme to customize the prompt. Take a look at this variant of the agnoster theme for an example of how this might look.

example prompt

example prompt for projects


Shell hooks

Shell hooks are supported in general. Since they are executed inside of bash before the zsh shell is spawned they aren't executed in the same environment. This means that things like aliases wont work.


Please do. Pull requests welcome.

You can’t perform that action at this time.