Skip to content
<awesome-gh-repos>
vic

jbadeau/mise-nix

A backend plugin for Mise that allows you to install and manage packages using Nix
Source code at GitHub https://github.com/jbadeau/mise-nix
jbadeau/mise-nix.json
{
  "createdAt": "2025-07-16T12:38:42Z",
  "defaultBranch": "main",
  "description": "A backend plugin for Mise that allows you to install and manage packages using Nix",
  "fullName": "jbadeau/mise-nix",
  "homepage": "",
  "language": "Lua",
  "name": "mise-nix",
  "pushedAt": "2026-01-11T19:44:10Z",
  "stargazersCount": 111,
  "topics": [
    "asdf",
    "devbox",
    "devenv",
    "flake",
    "flox",
    "home-manger",
    "manager",
    "mise",
    "nix",
    "plugin",
    "tools"
  ],
  "updatedAt": "2026-01-19T12:00:31Z",
  "url": "https://github.com/jbadeau/mise-nix"
}

mise-nix

Section titled “mise-nix”

A Mise plugin that brings the power of the Nix ecosystem to your development workflow.

Features

Section titled “Features”
  • 🚀 100,000+ packages from nixpkgs
  • 🔌 VSCode extensions support
  • 🔌 JetBrains plugins support

Prerequisites

Section titled “Prerequisites”

Installation

Section titled “Installation”
Terminal window
mise plugin install nix https://github.com/jbadeau/mise-nix.git

Quick Start

Section titled “Quick Start”
Terminal window
# List available versions
mise ls-remote nix:hello


# Install version
mise install nix:hello@2.12.1

Usage

Section titled “Usage”
Section titled “Standard Packages (Recommended)”

Uses nixhub.io for pre-built, cached packages:

Terminal window
# Latest version
mise install nix:hello


# Specific version
mise install nix:hello@2.12.1


# Version aliases
mise install nix:hello@stable

Flake References

Section titled “Flake References”
Terminal window
# GitHub
mise install "nix:hello@github+nixos/nixpkgs"
mise install "nix:hello@nixos/nixpkgs#hello"


# GitLab
mise install "nix:mytool@gitlab+group/project"


# Git HTTPS URLs
mise install "nix:hello@https+github.com/nixos/nixpkgs.git#hello"


# Git SSH URLs
mise install "nix:mytool@ssh+git@github.com/owner/repo.git#default"

Local Flakes

Section titled “Local Flakes”
Terminal window
export MISE_NIX_ALLOW_LOCAL_FLAKES=true
mise install "nix:mytool@./my-project"

VSCode Extensions

Section titled “VSCode Extensions”
Terminal window
mise install "nix:vscode+install=vscode-extensions.golang.go"

Unfree Packages

Section titled “Unfree Packages”

Some packages (e.g. Discord) are marked as unfree in nixpkgs. To install them:

Terminal window
# Using MISE_NIX env var (recommended - auto-sets NIXPKGS_ALLOW_UNFREE)
export MISE_NIX_ALLOW_UNFREE=true
mise install nix:discord


# Or using native Nix env var directly
export NIXPKGS_ALLOW_UNFREE=1
mise install nix:discord

Insecure Packages

Section titled “Insecure Packages”

Some packages with known vulnerabilities require explicit opt-in:

Terminal window
# Using MISE_NIX env var (recommended - auto-sets NIXPKGS_ALLOW_INSECURE)
export MISE_NIX_ALLOW_INSECURE=true
mise install nix:some-package


# Or using native Nix env var directly
export NIXPKGS_ALLOW_INSECURE=1
mise install nix:some-package

JetBrains Plugins

Section titled “JetBrains Plugins”

Install plugins from the nix-jetbrains-plugins repository:

Terminal window
# Install File Watchers plugin for IntelliJ IDEA Ultimate (Linux)
mise install "nix:jetbrains+install=jetbrains-plugins.x86_64-linux.idea-ultimate.2024.3.com.intellij.plugins.watcher"


# Install File Watchers plugin for IntelliJ IDEA Ultimate (macOS)
mise install "nix:jetbrains+install=jetbrains-plugins.aarch64-darwin.idea-ultimate.2024.3.com.intellij.plugins.watcher"


# Install GitToolBox for GoLand
mise install "nix:jetbrains+install=jetbrains-plugins.x86_64-linux.goland.2024.3.zielu.gittoolbox"


# Install Database Tools for WebStorm
mise install "nix:jetbrains+install=jetbrains-plugins.x86_64-linux.webstorm.2024.3.com.intellij.database"

The plugin will be automatically extracted to the correct JetBrains IDE plugin directory. Restart your IDE to activate the installed plugins.

Notes:

  • The system architecture (e.g., x86_64-linux, aarch64-darwin) must match your current system
  • Plugins are built directly from the nix-jetbrains-plugins flake repository without querying nixhub
  • You can find plugin IDs at the bottom of JetBrains Marketplace pages

Limitations

Section titled “Limitations”

Mise rejects colons (:) in version strings. Use these workaround prefixes:

Instead ofUse
github:owner/repogithub+owner/repo
gitlab:group/projectgitlab+group/project
git+https://host/repo.githttps+host/repo.git
git+ssh://git@host/repo.gitssh+git@host/repo.git

Configuration

Section titled “Configuration”

Environment variables can be used to configure this plugin:

VariableDescription
MISE_NIX_ALLOW_UNFREESet to true to allow unfree packages (auto-sets NIXPKGS_ALLOW_UNFREE=1)
MISE_NIX_ALLOW_INSECURESet to true to allow insecure packages (auto-sets NIXPKGS_ALLOW_INSECURE=1)
MISE_NIX_ALLOW_LOCAL_FLAKESSet to true to enable local flake references
MISE_NIX_NIXHUB_BASE_URLCustom nixhub.io URL
MISE_NIX_NIXPKGS_REPO_URLCustom nixpkgs repository URL

Native Nix env vars are also supported:

VariableDescription
NIXPKGS_ALLOW_UNFREESet to 1 to allow unfree packages (enables --impure)
NIXPKGS_ALLOW_INSECURESet to 1 to allow insecure packages (enables --impure)

Nix Setup

Section titled “Nix Setup”

Add to ~/.config/nix/nix.conf:

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

Section titled “Development”

Setup and Tests

Section titled “Setup and Tests”

Install Lua via brew (asdf plugin has a bug with LuaRocks 3.13.0):

Terminal window
brew install lua luarocks
Terminal window
mise init  # Link the plugin
mise test  # Unit tests
mise e2e   # Integration tests