You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
`mise-nix` is a backend plugin for [Mise](https://github.com/jdx/mise) that allows you to install and manage packages using [Nix](https://nixos.org/).
3
+
A [Mise](https://github.com/jdx/mise)plugin that brings the power of the [Nix](https://nixos.org/) ecosystem to your development workflow.
4
4
5
-
## Why use this plugin?
5
+
## Features
6
6
7
-
- 🚀 Access to over 100,000 packages
8
-
- ⚡ Better Nix developer experience
9
-
- 📦 Install VSCode extensions
7
+
- 🚀 **100,000+ packages** from nixpkgs
8
+
- 📦 **VSCode extensions** support
10
9
11
10
## Prerequisites
12
11
@@ -29,9 +28,9 @@ mise ls-remote nix:hello
29
28
mise install nix:hello@2.12.1
30
29
```
31
30
32
-
## Complete Usage Guide
31
+
## Usage
33
32
34
-
### Standard Nixpkgs Packages (Recommended - Fast & Cached)
33
+
### Standard Packages (Recommended)
35
34
36
35
Uses nixhub.io for pre-built, cached packages:
37
36
@@ -46,152 +45,56 @@ mise install nix:hello@2.12.1
46
45
mise install nix:hello@stable
47
46
```
48
47
49
-
### GitHub Sources
50
-
51
-
Uses GitHub shorthand for fast access:
48
+
### Flake References
52
49
53
50
```sh
54
-
#From nixpkgs GitHub repository (default branch)
51
+
# GitHub
55
52
mise install "nix:hello@github+nixos/nixpkgs"
56
-
57
-
# From specific branch
58
-
mise install "nix:hello@github+nixos/nixpkgs/nixos-unstable"
59
-
60
-
# From specific release/tag
61
-
mise install "nix:hello@github+nixos/nixpkgs?ref=23.11"
62
-
63
-
# From specific commit SHA
64
-
mise install "nix:hello@github+nixos/nixpkgs/abc123def456"
65
-
66
-
# With revision parameter
67
-
mise install "nix:hello@github+nixos/nixpkgs?rev=abc123def456"
68
-
69
-
# With subdirectory (flake in subdirectory)
70
-
mise install "nix:mytool@github+company/monorepo/main?dir=packages/tool"
71
-
72
-
# GitHub shorthand syntax (alternative)
73
53
mise install "nix:hello@nixos/nixpkgs#hello"
74
-
```
75
-
76
-
### GitLab Sources
77
54
78
-
Uses GitLab shorthand:
79
-
80
-
```sh
81
-
# From GitLab repository
55
+
# GitLab
82
56
mise install "nix:mytool@gitlab+group/project"
83
-
```
84
57
85
-
### Raw Git Sources
86
-
87
-
Uses full Git URLs for maximum compatibility:
88
-
89
-
```sh
90
-
# From raw git URL
58
+
# Git URLs
91
59
mise install "nix:hello@git+https://github.com/nixos/nixpkgs.git"
92
60
```
93
61
94
-
### Local Flakes (Experimental)
95
-
96
-
⚠️ **Experimental Feature**: Local flake support is experimental and subject to change.
97
-
98
-
For development with local Nix flakes:
62
+
### Local Flakes
99
63
100
64
```sh
101
65
export MISE_NIX_ALLOW_LOCAL_FLAKES=true
102
-
103
-
# Local development
104
66
mise install "nix:mytool@./my-project"
105
67
```
106
68
107
-
### VSCode Extensions (Experimental)
108
-
109
-
Install VSCode extensions using vscode+install syntax. Extensions are installed by creating a VSIX package from the Nix store and installing it in VSCode:
69
+
### VSCode Extensions
110
70
111
71
```sh
112
72
mise install "nix:vscode+install=vscode-extensions.golang.go"
113
73
```
114
74
115
-
The extension files are symlinked for access, and a VSIX package is created and installed in VSCode for IDE integration.
75
+
## Limitations
116
76
117
-
## Known Limitations
77
+
Use `github+` instead of `github:` due to mise parsing limitations.
118
78
119
-
Due to mise's argument parsing limitations, some Git URL formats require workarounds:
79
+
## Configuration
120
80
121
-
### Git Hosting Shorthand Limitations
81
+
Environment variables:
122
82
123
83
```sh
124
-
# ❌ Not supported (direct prefixes with colons)
125
-
mise install nix:hello@github:nixos/nixpkgs#hello
126
-
mise install nix:mytool@gitlab:group/project#default
127
-
128
-
# ✅ Use these workarounds instead
129
-
mise install "nix:hello@github+nixos/nixpkgs"
130
-
mise install "nix:mytool@gitlab+group/project"
84
+
export MISE_NIX_ALLOW_LOCAL_FLAKES=true # Enable local flakes
0 commit comments