feat: Minor improvements

Author: jbadeau

.github/workflows/ci.yml

@@ -31,23 +31,33 @@ jobs:
           curl https://mise.run | sh
           echo "$HOME/.local/bin" >> $GITHUB_PATH
 
-      # Install tools from mise.toml (node, lua)
-      - name: Install mise tools
-        run: mise install
-
-      - run: npm ci --legacy-peer-deps
-
       - name: Install nix
-        uses: cachix/install-nix-action@v23
+        uses: cachix/install-nix-action@v30
         with:
+          nix_path: nixpkgs=channel:nixos-unstable
           extra_nix_config: |
             experimental-features = nix-command flakes
             accept-flake-config = true
 
-      # Run mise tests
+      # Run mise init first to link the nix plugin
       - name: Run mise init
         run: mise init
 
+      # Install tools from mise.toml (node, lua, nix:shellspec)
+      - name: Install mise tools
+        run: mise install
+
+      # Install VSCode and virtual display for extension tests
+      - name: Install VSCode and dependencies
+        run: |
+          wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
+          sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
+          sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
+          sudo apt update
+          sudo apt install -y code xvfb
+
+      - run: npm ci --legacy-peer-deps
+
       # Run tests and build (use mise to ensure tools are in PATH)
       - name: Run tests
         run: mise exec -- npx nx run-many -t lint test e2e
@@ -72,23 +82,33 @@ jobs:
           curl https://mise.run | sh
           echo "$HOME/.local/bin" >> $GITHUB_PATH
 
-      # Install tools from mise.toml (node, lua)
-      - name: Install mise tools
-        run: mise install
-
-      - run: npm ci --legacy-peer-deps
-
       - name: Install nix
-        uses: cachix/install-nix-action@v23
+        uses: cachix/install-nix-action@v30
         with:
+          nix_path: nixpkgs=channel:nixos-unstable
           extra_nix_config: |
             experimental-features = nix-command flakes
             accept-flake-config = true
 
-      # Run mise tests
+      # Run mise init first to link the nix plugin
       - name: Run mise init
         run: mise init
 
+      # Install tools from mise.toml (node, lua, nix:shellspec)
+      - name: Install mise tools
+        run: mise install
+
+      # Install VSCode and virtual display for extension tests
+      - name: Install VSCode and dependencies
+        run: |
+          wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
+          sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
+          sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
+          sudo apt update
+          sudo apt install -y code xvfb
+
+      - run: npm ci --legacy-peer-deps
+
       # Run tests and build (use mise to ensure tools are in PATH)
       - name: Run tests
         run: mise exec -- npx nx run-many -t lint test e2e

CHANGELOG.md

@@ -1,12 +1,11 @@
 # `mise-nix`
 
-`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/).
+A [Mise](https://github.com/jdx/mise) plugin that brings the power of the [Nix](https://nixos.org/) ecosystem to your development workflow.
 
-## Why use this plugin?
+## Features
 
-- 🚀 Access to over 100,000 packages
-- ⚡ Better Nix developer experience
-- 📦 Install VSCode extensions
+- 🚀 **100,000+ packages** from nixpkgs
+- 📦 **VSCode extensions** support
 
 ## Prerequisites
 
@@ -29,9 +28,9 @@ mise ls-remote nix:hello
 mise install nix:hello@2.12.1
 ```
 
-## Complete Usage Guide
+## Usage
 
-### Standard Nixpkgs Packages (Recommended - Fast & Cached)
+### Standard Packages (Recommended)
 
 Uses nixhub.io for pre-built, cached packages:
 
@@ -46,152 +45,56 @@ mise install nix:hello@2.12.1
 mise install nix:hello@stable
 ```
 
-### GitHub Sources
-
-Uses GitHub shorthand for fast access:
+### Flake References
 
 ```sh
-# From nixpkgs GitHub repository (default branch)
+# GitHub
 mise install "nix:hello@github+nixos/nixpkgs"
-
-# From specific branch
-mise install "nix:hello@github+nixos/nixpkgs/nixos-unstable"
-
-# From specific release/tag
-mise install "nix:hello@github+nixos/nixpkgs?ref=23.11"
-
-# From specific commit SHA
-mise install "nix:hello@github+nixos/nixpkgs/abc123def456"
-
-# With revision parameter
-mise install "nix:hello@github+nixos/nixpkgs?rev=abc123def456"
-
-# With subdirectory (flake in subdirectory)
-mise install "nix:mytool@github+company/monorepo/main?dir=packages/tool"
-
-# GitHub shorthand syntax (alternative)
 mise install "nix:hello@nixos/nixpkgs#hello"
-```
-
-### GitLab Sources
 
-Uses GitLab shorthand:
-
-```sh
-# From GitLab repository
+# GitLab
 mise install "nix:mytool@gitlab+group/project"
-```
 
-### Raw Git Sources
-
-Uses full Git URLs for maximum compatibility:
-
-```sh
-# From raw git URL
+# Git URLs
 mise install "nix:hello@git+https://github.com/nixos/nixpkgs.git"
 ```
 
-### Local Flakes (Experimental)
-
-⚠️ **Experimental Feature**: Local flake support is experimental and subject to change.
-
-For development with local Nix flakes:
+### Local Flakes
 
 ```sh
 export MISE_NIX_ALLOW_LOCAL_FLAKES=true
-
-# Local development
 mise install "nix:mytool@./my-project"
 ```
 
-### VSCode Extensions (Experimental)
-
-Install VSCode extensions using vscode+install syntax. Extensions are installed by creating a VSIX package from the Nix store and installing it in VSCode:
+### VSCode Extensions
 
 ```sh
 mise install "nix:vscode+install=vscode-extensions.golang.go"
 ```
 
-The extension files are symlinked for access, and a VSIX package is created and installed in VSCode for IDE integration.
+## Limitations
 
-## Known Limitations
+Use `github+` instead of `github:` due to mise parsing limitations.
 
-Due to mise's argument parsing limitations, some Git URL formats require workarounds:
+## Configuration
 
-### Git Hosting Shorthand Limitations
+Environment variables:
 
 ```sh
-# ❌ Not supported (direct prefixes with colons)
-mise install nix:hello@github:nixos/nixpkgs#hello
-mise install nix:mytool@gitlab:group/project#default
-
-# ✅ Use these workarounds instead
-mise install "nix:hello@github+nixos/nixpkgs"
-mise install "nix:mytool@gitlab+group/project"
+export MISE_NIX_ALLOW_LOCAL_FLAKES=true  # Enable local flakes
+export MISE_NIX_NIXHUB_BASE_URL="https://custom.nixhub.io"  # Custom nixhub
 ```
 
-### Git URL Workarounds
-
-Mise rejects `git+ssh://` and `git+https://` as invalid prefixes, so use these alternatives:
+## Nix Setup
 
-| Prefix | Converts To | Use Case |
-|--------|-------------|----------|
-| `ssh+git@host/repo.git` | `git+ssh://git@host/repo.git` | SSH access |
-| `https+user:token@host/repo.git` | `git+https://user:token@host/repo.git` | HTTPS auth |
-
-```sh
-# ❌ These don't work due to mise parsing
-mise install "nix:hello@git+ssh://git@github.com/nixos/nixpkgs.git"
-mise install "nix:hello@git+https://user:token@github.com/nixos/nixpkgs.git"
-
-# ✅ Use these workarounds instead
-mise install "nix:hello@ssh+git@github.com/nixos/nixpkgs.git"
-mise install "nix:hello@https+user:token@github.com/nixos/nixpkgs.git"
-```
-
-## Settings
-
-```sh
-# Custom NixHub instance
-export MISE_NIX_NIXHUB_BASE_URL="https://custom-nixhub.example.com"
-
-# Custom NixPkgs repository
-export MISE_NIX_NIXPKGS_REPO_URL="https://github.com/custom/nixpkgs"
-
-# Enable local flakes (security risk)
-export MISE_NIX_ALLOW_LOCAL_FLAKES=true
-
-# Enterprise Git instances
-export MISE_NIX_GITHUB_ENTERPRISE_URL="github.company.com"
-export MISE_NIX_GITLAB_ENTERPRISE_URL="gitlab.company.com"
-```
-
-## Nix Configuration
-
-**Important:** Add to `~/.config/nix/nix.conf` for optimal performance:
+Add to `~/.config/nix/nix.conf`:
 
 ```ini
 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=
 ```
 
-Without this configuration, package installations will be significantly slower as Nix will build from source instead of using pre-built binaries.
-
-## Troubleshooting
-
-**"Package not found"**: Check package exists on [NixHub](https://www.nixhub.io)
-
-**"Invalid prefix"**: Use `github+` syntax instead of direct `github:`
-
-**"Local flakes disabled"**: Set `MISE_NIX_ALLOW_LOCAL_FLAKES=true`
-
-**Build failures**: Ensure Nix experimental features are enabled
-
-**Slow installs**: Avoid full git URLs for large repositories
-
-**VSCode extensions not showing**: Restart VSCode after installing extensions
-
 ## Development
 
 ```sh

README.md

@@ -19,7 +19,7 @@ function PLUGIN:BackendListVersions(ctx)
   local current_os = platform.normalize_os(RUNTIME.osType)
   local current_arch = RUNTIME.archType:lower()
 
-  local success, data, response = nixhub.fetch_metadata_cached(tool, 3600)
+  local success, data, response = nixhub.fetch_metadata(tool)
 
   -- Validate tool metadata and throw error if not found
   nixhub.validate_metadata(success, data, tool, response)