Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/haslersn/any-nix-shell

fish and zsh support for the nix run and nix-shell environments of the Nix package manager
https://github.com/haslersn/any-nix-shell

Last synced: about 2 months ago
JSON representation

fish and zsh support for the nix run and nix-shell environments of the Nix package manager

Host: GitHub
URL: https://github.com/haslersn/any-nix-shell
Owner: haslersn
License: mit
Created: 2018-09-10T16:36:27.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-07-23T16:03:52.000Z (2 months ago)
Last Synced: 2024-07-24T14:03:18.167Z (2 months ago)
Language: Shell
Homepage:
Size: 36.1 KB
Stars: 241
Watchers: 7
Forks: 17
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# any-nix-shell

`fish`, `xonsh`, and `zsh` support for the `nix run` and `nix-shell`
environments of the Nix package manager.

Features:

* When entering a `nix run` or `nix-shell` environment, the shell stays the same.
* Inside those environments, your prompt prints the loaded packages to the right.
* Alternatively, print that information by executing: `nix-shell-info`
* `nix-shell --command` or the like still execute inside `bash`, such that scripts don't break.

## Installation

any-nix-shell can be installed from stable nixpkgs.
For instance,

```console
$ nix-env -i any-nix-shell
```

installs `any-nix-shell` into your user environment.

## Enabling

In the following we describe how to enable the `any-nix-shell` plugin
for your user.
This differs slightly among `fish`, `xonsh`, and `zsh`.

### `fish`

Add the following to your *~/.config/fish/config.fish*.
Create it if it doesn't exist.

```fish
any-nix-shell fish --info-right | source
```

### `xonsh`

Add the following to your `xonsh`
[configuration file](https://xon.sh/xonshrc.html).
(Create it if it doesn't exist.)

```xonsh
execx($(any-nix-shell xonsh --info-right))
```

### `zsh`

Add the following to your *~/.zshrc*.
Create it if it doesn't exist.

```zsh
any-nix-shell zsh --info-right | source /dev/stdin
```

## System-wide enabling on NixOS

Alternatively the `any-nix-shell` plugin can be enabled system-wide.
This enables it for every user.
To do so, add the following to your configuration (*/etc/nixos/configuration.nix*).

### `fish`

```nix
{
programs.fish.enable = true;
programs.fish.promptInit = ''
${pkgs.any-nix-shell}/bin/any-nix-shell fish --info-right | source
'';
}
```

### `xonsh`

```nix
{
programs.xonsh.enable = true;
programs.xonsh.config = ''
execx($(${pkgs.any-nix-shell}/bin/any-nix-shell xonsh --info-right))
'';
}
```

### `zsh`

```nix
{
programs.zsh.enable = true;
programs.zsh.promptInit = ''
${pkgs.any-nix-shell}/bin/any-nix-shell zsh --info-right | source /dev/stdin
'';
}
```

### `zsh` with home-manager

```nix
{
programs.zsh.enable = true;
programs.zsh.initExtra = ''
any-nix-shell zsh --info-right | source /dev/stdin
'';
}
```

## Customization

The `any-nix-shell` command (which is used for enabling the plugin in a specific shell) **optionally** takes any of the following flags: