Overview

The mise-nix project is a powerful plugin for Mise, integrating the extensive capabilities of the Nix package manager directly into your development environment. This plugin simplifies the installation and management of a vast array of packages, enhancing developer productivity and streamlining workflows.

Key Features

• Access to Over 100,000 Packages: Leverage the extensive collection in nixpkgs, ensuring a comprehensive toolset for diverse development needs.
• Support for VSCode Extensions: Seamlessly install and manage VSCode extensions, enriching the coding experience.
• JetBrains Plugin Compatibility: Install various JetBrains plugins effortlessly, integrating necessary tools into popular IDEs.

Getting Started

To quickly kick off using mise-nix, a few commands will set you on the right path:

Listing and Installing Packages

# List available versions of a package
mise ls-remote nix:hello

# Install a specific version of a package
mise install nix:hello@2.12.1

Package Installation Options

1. Standard Packages (Recommended): Use pre-built, cached packages from nixhub.io:

   mise install nix:hello         # Install the latest version
   mise install nix:hello@2.12.1  # Install a specific version
   mise install nix:hello@stable   # Install the stable version
   

2. Flake References: Install packages from GitHub, GitLab, or Git URLs with ease:

   mise install "nix:hello@github+nixos/nixpkgs"
   mise install "nix:mytool@gitlab+group/project"
   mise install "nix:hello@git+https://github.com/nixos/nixpkgs.git"
   

3. Local Flakes: Enable local development by setting the appropriate environment variable:

   export MISE_NIX_ALLOW_LOCAL_FLAKES=true
   mise install "nix:mytool@./my-project"
   

4. IDE-Specific Plugins: Install JetBrains plugins directly from the nix-jetbrains-plugins repository:

   mise install "nix:jetbrains+install=jetbrains-plugins.x86_64-linux.idea-ultimate.2024.3.com.intellij.plugins.watcher"
   

   The plugin will be extracted to the correct JetBrains IDE plugin directory, and restarting the IDE will activate the installed plugins.

Configuration and Setup

To customize your settings, modify environment variables as needed:

eport MISE_NIX_ALLOW_LOCAL_FLAKES=true  # Allow local flakes
export MISE_NIX_NIXHUB_BASE_URL="https://custom.nixhub.io"  # Set a custom nixhub

Additionally, ensure Nix is set up properly in your configuration. Edit the ~/.config/nix/nix.conf to include:

experimental-features = nix-command flakes
substituters = https://cache.nixos.org https://nix-community.cachix.org
trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= nix-community.cachix.org-1:0VI8sF6Vsp2Jxw8+OFeVfYVdIY7X+GTtY+lR78QAbXs=

Development and Testing

For developers contributing to the project, the provided commands facilitate setup and testing:

# Setup
mise init  # Install and link necessary components

# Testing
mise test  # Run unit tests
mise e2e    # Execute integration tests

mise-nix empowers developers with easy access to package management through Nix, significantly enhancing the overall development experience.