Skip to content
CAI
Software that uses CAICheck a score

jdx/mise

62.0

Adequate · 26 October 2026

559.5k

lines of production code

Rust

with TypeScript

6

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Mise is a polyglot development environment manager that unifies the installation and versioning of tools, runtimes, and system packages. It provides a unified CLI for managing tool versions, executing project tasks, and handling environment variables, while supporting declarative configuration for system-level dependencies and dotfiles. The system integrates with AI coding agents, offers native OCI image building, and includes robust security features like artifact attestation verification and secrets management.

How it got here

2023–2024 — Rebranding to mise and architectural modernization

67 changes.

The project underwent a comprehensive rebranding from RTX to mise, updating all packaging, CLI, and configuration systems to reflect the new identity. This period focused on modernizing the underlying architecture by replacing the CLI argument parser, refactoring the task and environment execution engines, and expanding support for new shells and plugin backends like vfox and aqua.

2025–2026 — vfox plugin runtime and system management expansion

94 changes.

This period focused on establishing the vfox plugin ecosystem by building a comprehensive Rust-based runtime with embedded Lua support, extensive hook interfaces, and a suite of built-in plugins. Concurrently, the project significantly expanded its system management capabilities, introducing declarative bootstrap for OS packages, user accounts, and dotfiles, alongside new features for dependency management, OCI image packaging, and secrets integration.

Features

Add Bash support for Zsh-like chpwd directory-change hooks

Users can now register and execute custom functions when changing directories in Bash, mimicking Zsh's chpwd hook behavior. This new asset provides a \\_\_zsh\_like\_cd\ wrapper that intercepts \cd\, \pushd\, and \popd\ commands to trigger registered hooks, allowing scripts and configurations to react to directory changes in Bash environments.

_src/assets/bash\_zsh\support · high confidence

Add CLI commands to manage Homebrew taps for bootstrap packages

Users can now add or remove Homebrew taps directly via the CLI using \mise bootstrap packages brew tap\ and \mise bootstrap packages brew untap\. These commands update the \\[bootstrap.brew.taps\]\ section in the configuration file, allowing mise to fetch formulae and casks from custom repositories without requiring a local Homebrew installation. The commands support writing to local or global config files and include dry-run modes to preview changes.

src/cli/system/brew · high confidence

Add \`mise secrets ls\` command to list available secrets

Users can now run \mise secrets ls\ (or \mise secrets\) to inspect the project's configured secrets source (declared via \\[secrets.fnox\]\ in \mise.toml\). The command lists secret names, their injection modes (shell, exec, or never), whether they are provided as files, which tasks or scopes can access them, and any associated descriptions, without exposing the actual secret values. Output is available in table format (default) or JSON (\--json\), and the command is currently experimental.

src/cli/secrets · high confidence

Add attestation plugin with pre-install metadata hook

A new 'attestation' plugin (v0.1.0) has been added to the vfox plugin system. It includes a pre-install hook that returns version and URL information along with GitHub artifact attestation metadata (owner and repo), enabling tools to verify provenance during installation.

crates/vfox/plugins/attestation · high confidence

Add dummy backend plugin for testing environment variable propagation

A new dummy backend plugin has been added to the vfox plugin system to facilitate testing of environment variable propagation to backend hooks. This plugin exposes three hooks: \BackendListTools\ (returning static tool definitions), \BackendSearchTools\ (supporting dynamic search queries), and \BackendListVersions\ (which attempts to read the \MY\_TEST\_VAR\ environment variable to demonstrate env passing, falling back to 'fallback' if unavailable). The plugin is versioned at 0.1.0 and requires runtime version 0.3.0 or higher.

crates/vfox/plugins/dummy-backend · high confidence

Add man page for mise CLI

The project now includes a man page (man/man1/mise.1) for the mise command-line interface, providing users with local documentation access to the tool's options, arguments, and commands.

man · high confidence

Add support for Elvish, Nushell, PowerShell, and Xonsh shells

The shell activation system now supports four additional shells: Elvish, Nushell, PowerShell (Pwsh), and Xonsh. This introduces new shell implementations that generate activation scripts, environment variable handling, and deactivation logic specific to each shell's syntax and behavior, expanding the tool's compatibility beyond the previously supported Bash, Fish, and Zsh.

src/shell · high confidence

Add test-nodejs plugin for local vfox testing

A new test plugin named 'test-nodejs' has been added to the vfox plugin system to facilitate local testing without requiring network access. This plugin provides a hardcoded list of Node.js versions (including 18, 19, and 20 series) and their associated npm versions, simulates installation via local file paths, and supports legacy version files like .node-version and .nvmrc. It is designed specifically for internal validation of the vfox runtime rather than production use.

crates/vfox/plugins/test-nodejs · high confidence

Add vfox crate with embedded plugin support

The vfox crate has been added to the workspace, providing a Rust interface to the vfox version manager. It includes a build script that embeds Lua-based plugin code directly into the binary, allowing plugins to be bundled and accessed without external file dependencies at runtime. The crate also includes standard project configuration files such as a license, README, and mise task definitions for building and testing.

crates/vfox · high confidence

Added CLI logo and shell completion definitions

The CLI now displays a text-based logo on the help page, improving visual identity. Additionally, shell completion scripts have been enhanced with specific completions for commands like \alias\, \config\_file\, \plugin\, \setting\, \task\, \tool\, and \tool@version\, allowing for more accurate and context-aware tab-completion in supported shells.

src/assets · high confidence

Added Cursor AI development and testing rules

New Cursor AI configuration files have been added to guide developers on project workflows. The \conventional\_commits.mdc\ rule enforces specific commit and PR title formatting, defining allowed types (such as \feat\, \fix\, \chore\) and scopes. The \development.mdc\ rule provides standard commands for building, running, and linting the project using \mise\. The \testing.mdc\ rule specifies how to execute unit and end-to-end tests, including handling of slow tests and GitHub API rate limits.

.cursor/rules · high confidence

Added HTML parser library to vfox Lua environment

The vfox Lua environment now includes a new HTML parsing library located in crates/vfox/lua/htmlparser. This addition introduces core components including ElementNode for representing parsed HTML structures, voidelements for identifying self-closing tags, and the main htmlparser module which handles parsing logic, including template placeholder escaping and attribute handling. This enables Lua scripts within vfox to parse and manipulate HTML content.

crates/vfox/lua · high confidence

Added automated bootstrap for Cursor Cloud development environment

Developers using the Cursor Cloud agent now have an automated setup process for the 'mise development' environment. A new \.cursor/environment.json\ file defines the environment name and user, while \.cursor/install.sh\ provides an idempotent script that installs necessary system dependencies (such as Rust, Python, and shell tools), configures GitHub token synchronization, builds the mise binary, and sets up the PATH and trust configuration. This replaces the previous manual or Docker-based development setup, allowing the cloud agent to automatically prepare the workspace for building and testing.

.cursor · high confidence

Added mise-interactive-config crate for schema generation

A new crate, mise-interactive-config, has been added to the workspace. It includes a build script that reads the repository's mise.json schema file and generates Rust constants (such as SCHEMA\_SECTIONS, SCHEMA\_ENTRIES, SCHEMA\_SETTINGS, and SCHEMA\_HOOKS) containing metadata about valid configuration keys, their descriptions, and their data types. This provides a centralized, compile-time validated source of schema information for other parts of the application.

crates/mise-interactive-config · high confidence

Added task-cache benchmark harness

A new benchmark suite has been added to measure the performance of the task artifact cache. The \benchmarks/task-cache\ directory now contains a shell script and documentation that allow users to run \mise run perf:task-cache\ to measure wall-clock times for hashing sources, publishing and restoring artifacts, and traversing task graphs with cache hits. The harness creates an isolated temporary project with configurable parameters (defaulting to 2,000 source files, a 32 MiB artifact, and 500 graph nodes) to provide a realistic signal of cache performance against the release binary.

benchmarks/task-cache · high confidence

Claude Code integration with session hooks and Entire CLI support

This change introduces configuration for Claude Code within the .claude directory, enabling automated session management and integration with the Entire CLI. A new session-start hook script bootstraps the environment for remote web sessions by reusing the existing Cloud Agent setup and ensuring mise shims are available in the PATH. The settings.json file defines a comprehensive set of hooks (SessionStart, PostToolUse, PreToolUse, SessionEnd, Stop, SubagentStop, UserPromptSubmit) that trigger Entire CLI commands when the tool is installed, allowing for task tracking and session lifecycle management. Additionally, a symlink to .agents/skills is created to provide Claude Code with access to project-specific skills.

.claude · high confidence

Declarative management of system users, groups, and services

Users can now declare Linux system users and groups in the configuration to have mise create, update, or remove them declaratively. This change introduces the \src/system/accounts\ module to handle user/group lifecycle and the \src/system/compose\ module to manage Docker Compose projects, alongside new modules for system dependencies (\deps\), service drivers (\driver\), and firewall rules (\firewall\). Also in this area: Support for declarative apt repositories and PPAs via \[bootstrap.apt.sources\].

src/system · high confidence

Declarative system package management via \`mise bootstrap packages\`

Users can now manage operating-system-level software declaratively using the new \mise bootstrap packages\ command group. This feature introduces subcommands to install (\apply\), upgrade (\upgrade\), and remove (\prune\) packages across multiple managers (including Homebrew, apt, pacman, winget, flatpak, and others) based on declarations in \\[bootstrap.packages\]\. It also provides \use\ to add packages to the config and \status\ to check their state, \import\ to migrate existing Homebrew installations into the config, and \export\ to generate NixOS modules from the current setup.

src/cli/system · high confidence

Experimental OCI image build, push, and run commands

Added the \mise oci\ subcommand group (build, push, run) to package project toolsets into OCI container images. The build command creates an image layout where each tool version is a separate content-addressable layer, allowing efficient reuse when only specific tools change. The push command uploads images to registries using a built-in client (removing the external skopeo/crane dependency) and supports layer caching and multi-arch index updates. The run command builds an image and executes commands inside it via Docker or Podman. By default, builds are scoped to the project's mise configuration, excluding global user tools, and require the experimental feature flag.

src/cli/oci · high confidence

IDE support for vfox plugins via Lua type definitions

Added \mise-plugin.lua\, a LuaCATS type definition file that provides IDE autocompletion and type checking for vfox plugin development. This file defines the structure of the global \RUNTIME\ object (including \osType\, \archType\, and \envType\), the \PLUGIN\ table with all supported hook signatures (such as \Available\, \PreInstall\, \PostInstall\, \EnvKeys\, \MiseEnv\, \MisePath\, \MiseInstallSatisfied\, \BackendListVersions\, \BackendInstall\, \BackendExecEnv\, and \BackendUninstall\), and built-in modules like \http\, \json\, and \file\ (including \FileStat\).

crates/vfox/types · high confidence

Initial implementation of vfox plugin hook scripts

Added the core Lua hook implementations for the vfox plugin system, including \available.lua\ to list supported versions, \env\_keys.lua\ to configure environment variables (specifically PATH) based on the operating system, and \pre\_install.lua\ and \post\_install.lua\ to manage the installation lifecycle. These files establish the foundational behavior for how the plugin interacts with the vfox runtime during version availability checks and SDK installation.

crates/vfox/plugins/hooks · high confidence

Installer renamed from RTX to mise and added musl/ARMv7 support

The standalone installer script has been renamed from RTX to mise, updating all environment variable checks (e.g., RTX\_DEBUG to MISE\_DEBUG) and error messages to reflect the new product name. The script now detects musl libc environments (including Android/Termux) and supports ARMv7 architectures, providing specific prebuilt binaries for these platforms. Additionally, the installer now intelligently selects between zstd-compressed and standard tar.gz archives based on system capabilities and version requirements.

packaging/standalone · high confidence

Integrate fnox as a secrets source with daemon caching

Added a new \fnox\ secrets source that resolves secrets by communicating with the fnox CLI and its background daemon. The implementation includes a daemon client (\daemon.rs\) that reads cached secrets from the fnox daemon's socket for performance, falling back to the fnox CLI if the daemon is unavailable, stuck, or disabled. The source (\mod.rs\) handles binary discovery, environment setup, and argument construction for fnox commands, while \wire.rs\ defines the JSON schema for parsing fnox's output. This allows users to configure fnox as a secret provider via \\[secrets.fnox\]\ in their project configuration.

src/secrets/fnox · high confidence

Introduce \`mise doctor\` subcommands for PATH and project diagnostics

The \mise doctor\ command now includes dedicated subcommands: \mise doctor path\ displays the PATH entries provided by mise (with a \--full\ flag to show all entries), and \mise doctor project\ runs configurable diagnostic checks defined in \\[doctor.checks\]\ within mise.toml, reporting pass/fail/error status for each. The main \mise doctor\ output also now includes a \self\_update\_available\ field in JSON output and reports shadowed shims, backend mismatches, and tools that provide no executables.

src/cli/doctor · high confidence

Introduce aqua, asdf, and asset\_matcher backend modules

The src/backend directory now includes the aqua backend (src/backend/aqua.rs), the asdf backend (src/backend/asdf.rs), and the unified asset matcher (src/backend/asset\_matcher.rs). The aqua backend integrates with the internal aqua registry to resolve, download, and install tools, supporting checksum verification, cosign/minisign signatures, and GitHub artifact attestations. The asdf backend wraps external asdf plugins, handling idiomatic version file parsing, environment setup, and bin path discovery. The asset\_matcher module provides a unified, platform-aware scoring system to select the best download asset from a list of candidates.

src/backend · high confidence

Introduce automated COPR packaging workflow

Added a Dockerfile and build script to enable automated RPM packaging and publishing to Fedora COPR. The Dockerfile sets up a Fedora 45 environment with necessary build tools and installs copr-cli via DNF for proper dependency management. The build script automates the creation of source tarballs, vendoring of Rust dependencies, generation of RPM spec files, and submission of builds to COPR, supporting multiple chroots including Fedora 43, 44, Rawhide, EPEL 10, and CentOS Stream 9.

packaging/copr · high confidence

Introduce bash activation, deactivation, and command-not-found integration scripts

This change adds the core Bash integration assets for mise: \activate.sh\ sets up the \mise\ shell function, environment variables, and prompt/chpwd hooks to manage tool versions; \deactivate.sh\ cleanly removes these hooks and variables to restore the previous shell state; and \command\_not\_found.sh\ integrates with Bash's \command\_not\_found\_handle\ to automatically resolve and execute commands via mise when they are not found in the standard PATH.

src/assets/bash · high confidence

Introduce compiled Aqua registry cache for faster lookups

The aqua-registry crate now supports caching compiled registry data to disk using the rkyv binary format. This change adds a new \RegistryCache\ component that stores both raw source YAML and pre-compiled package indexes, allowing the system to skip repeated YAML parsing and registry lookups when the source has not changed. Users benefit from significantly faster registry operations and reduced memory overhead, as the compiled cache is versioned and pruned automatically to ensure consistency.

crates/aqua-registry/src · high confidence

Introduce dedicated dependency management system with provider-based execution

A new dependency management subsystem has been added to handle tool and package installation via a provider architecture. This system introduces a dependency graph engine that schedules provider execution based on declared dependencies, supports scoped providers for monorepo environments, and persists freshness state (source/output hashes and command digests) to a dedicated state directory. It includes built-in support for various package managers (such as npm, pip, go, deno, and others) and allows configuration of run commands, sources, outputs, and environment variables, enabling automatic and ordered installation of project dependencies.

src/deps · high confidence

Introduce interactive TOML configuration editor

Users can now edit mise configuration files using a new interactive terminal-based editor (\mise edit\). This feature provides a structured, cursor-driven interface for managing tools, settings, and tasks, supporting features such as version selection for tools, boolean toggles for settings, and inline editing for complex values. The editor includes navigation via vim-style keys (j/k), undo/redo capabilities, and validation for environment variable formats, allowing users to modify their configuration without manually editing TOML files.

crates/mise-interactive-config/src/editor · high confidence

Introduce internal mise-bootstrap crate for declarative resource planning

A new internal \mise-bootstrap\ crate has been added to handle the declarative bootstrap workflow. It provides resource identity models, secret-safe plan output serialization, and dependency ordering logic. The crate validates the resource graph and produces an ordered execution plan, with bootstrap-specific dependency rules (such as file phases and account dependencies) implemented in the \policy\ module.

crates/mise-bootstrap · high confidence

Introduce mise language server for mise.toml configuration files

This change adds a new language server (mise-lsp) that provides IDE-like features for mise configuration files. It enables intelligent code completion for keys and tool names, hover documentation for configuration options and tools, and real-time diagnostics that flag syntax errors, unknown keys, and deprecated configuration keys. The server also supports semantic token highlighting to visually distinguish between tasks, tools, environment variables, and templates, and includes logic to handle task include files and rewrite deprecated keys.

crates/mise-lsp · high confidence

Introduce project-scoped secrets integration with fnox

Users can now configure a secrets provider for their project by adding a \\[secrets.fnox\]\ section to \mise.toml\, which restricts secret sources to project-level configuration files for security. This change introduces a new secrets subsystem that allows tasks to explicitly declare required secrets via a \secrets = \[...\]\ list and reference them in environment variables using \{{ secrets.NAME }}\ syntax. Additionally, the \mise x\ command now supports \--secrets\ and \--secrets-all\ flags to inject secrets into arbitrary commands, and a new \mise secrets ls\ command is available to list configured secrets and their usage.

src/secrets · high confidence

Introduce shell-alias command for managing shell aliases

Users can now manage shell aliases via the new \mise shell-alias\ command, which replaces the previous \alias\ command. This command provides subcommands to list (\ls\), retrieve (\get\), set (\set\), and remove (\unset\) aliases defined in the global configuration file (\\~/.config/mise/config.toml\). The \set\ subcommand supports both standard argument syntax and a \KEY=VALUE\ format for convenience.

_src/cli/shell\alias · high confidence

Introduce vfox plugin support with signed archive installation

Users can now install and manage plugins using the vfox ecosystem, including the ability to install plugins from signed packslip archives for enhanced security. The system automatically detects and loads vfox plugins alongside existing asdf plugins, and vfox plugins can be configured via mise.plugin.toml to specify package manager requirements and script caching. This adds a new plugin type that integrates with the existing tool installation workflow.

src/plugins · high confidence

Introduce vfox.rs as the Lua-based plugin runtime

This change adds the \crates/vfox\ crate, which serves as the new runtime for vfox-style plugins. It embeds Lua code into the binary, manages plugin loading from both filesystem and embedded sources, and exposes a structured API for hooks (install, env\_keys, pre\_uninstall, etc.) and system dependency detection. The runtime includes built-in HTTP retry logic with backoff, cancellation support, and integration with mise's attestation and URL rewriting systems, allowing plugins to interact with the host environment via a consistent Lua interface.

crates/vfox/src · high confidence

Introduction of remote cache protocol and core caching infrastructure

The \mise-cache-core\ crate has been introduced to provide the foundational implementation for the remote action cache. This change adds the core protocol definitions, including media types and header constants for the cache API, and implements the \RemoteCacheConfig\ structure for configuring remote cache connections (base URL, namespace, authentication tokens, and timeouts). It also defines the \CacheDigest\ struct for handling content-addressable storage digests using Blake3 and SHA-256, and establishes the \RemoteActionResult\ structure for serializing action results. This module serves as the low-level engine for cache interactions, supporting both local and remote caching modes.

crates/mise-cache-core · high confidence

Native Homebrew formula and cask evaluation shims

Added Ruby shim scripts for evaluating Homebrew formula and cask definitions without requiring a full Homebrew installation. The new \shim.rb\ and \cask\_shim.rb\ files implement a subset of the Homebrew DSL, allowing mise to parse, verify, and execute lifecycle hooks for formulae and casks directly. This enables system package management capabilities for Homebrew-managed software while maintaining security through SHA-256 verification of downloaded resources and explicit failure for unsupported DSL features.

ruby · high confidence

Native OCI image building and pushing without external tools

Mise now builds OCI images and pushes them to registries using a fully native Rust implementation, removing the previous dependency on external binaries like skopeo, crane, or docker. The new \src/oci\ module handles the entire lifecycle: it orchestrates the build with one content-addressable layer per tool version for efficient caching, constructs reproducible tar layers, and manages registry authentication by reading standard Docker/Podman credential files. It also supports pushing images directly to registries (including AWS ECR compatibility) and loading layouts into the Docker daemon via a streaming docker-archive conversion, all without requiring a container engine to be installed on the host. Also in this area: Fix OCI image packaging and backend switch warnings for aliased tools; Fix Rust toolchain packaging in OCI images.

src/oci · high confidence

Native binary installation support for Cargo packages

Users can now install Cargo packages via native pre-compiled binaries (binstall) instead of compiling from source, resulting in significantly faster installation times. This new capability, implemented in the \native\_binstall\ module, automatically discovers and downloads platform-specific binary artifacts from Crates.io, handling archive extraction and binary placement directly into the tool's bin directory.

src/backend/cargo · high confidence

Native workspace discovery for Cargo, Go, Node, and uv projects

The workspace detection logic in \src/task/workspace\ has been expanded to natively discover and resolve dependencies for Rust (Cargo), Go, Node.js, and Python (uv) ecosystems. New provider modules (\cargo.rs\, \go.rs\, \node.rs\, \uv.rs\) parse respective workspace manifests—such as \Cargo.toml\, \go.work\, \package.json\, and \pyproject.toml\—to identify member packages and their internal path dependencies. This enables the tool to automatically infer task dependencies and project structures within these multi-package workspaces without relying on external heuristics.

src/task/workspace · high confidence

New Cloudflare Worker for serving mise installation scripts

A new Cloudflare Worker (mise-run.js) has been added to proxy and serve mise installation scripts for bash, zsh, and fish shells. This worker handles GET requests to specific paths (/bash, /zsh, /fish, and /) by fetching the corresponding scripts from mise.jdx.dev, setting appropriate caching headers (1-hour immutable cache), and returning the content as plain text. This provides a reliable, cached endpoint for users to source or install mise via shell-specific URLs.

cloudflare · high confidence

New Lua modules for plugins: archiver, cmd, env, file, hooks, html, http, json, log, semver, and strings

Plugins now have access to a comprehensive set of Lua modules for common tasks. The \archiver\ module allows decompressing archives with optional path stripping. The \cmd\ module provides \exec\ and \stream\ for running commands with timeouts and interactive support, and routes \os.execute\/\os.getenv\ through mise's environment to avoid stale values. The \env\ module lets plugins set environment variables. The \file\ module adds \read\, \symlink\, \exists\, \stat\, \list\, \glob\, \move\, and \join\_path\ for file system operations. The \hooks\ module manages plugin lifecycle hooks. The \html\ module provides an HTML parser. The \http\ module offers \get\, \head\, \download\file\ (and their \try\\ variants) with retry logic and GitHub API authentication. The \json\ module handles encoding and decoding. The \log\ module provides structured logging levels and overrides \print\. The \semver\ module enables version parsing, comparison, and sorting. The \strings\ module offers string manipulation functions like \split\, \trim\, and \join\.

_crates/vfox/src/lua\mod · high confidence

New Sigstore attestation and signature verification crate

Added the \mise-sigstore\ crate to provide comprehensive verification for GitHub artifact attestations, keyless cosign signatures, and SLSA provenance. This new capability allows users to verify the integrity and origin of artifacts using Sigstore trust roots, including support for GitHub's internal Fulcio certificates, TUF-based trust root updates with retry logic, and strict signer identity enforcement for keyless and SLSA workflows.

crates/mise-sigstore · high confidence

New \`mise backends\` command to list and switch tool backends

Users can now manage tool backends directly via the CLI. The new \mise backends ls\ command lists all built-in backends available in the toolset. Additionally, \mise backends switch\ allows users to migrate locked tools to the backend currently specified by the registry, handling lockfile updates and reinstallation when a tool's backend has changed. The legacy \mise b\ alias for this command group is deprecated and will be removed in version 2027.4.0.

src/cli/backends · high confidence

New \`mise config\` subcommands for reading, writing, and listing configuration

Users can now manage mise configuration files directly via the CLI with \mise config get\, \mise config set\, and \mise config ls\. \config get\ retrieves specific values or the entire file from a target TOML source (local, global, or system), while \config set\ allows editing these files with support for dotted keys, type inference, and append/remove operations on collections. \config ls\ lists active configuration files and their associated tools, with options to output JSON or list tracked configs. These commands also feature shell completion for configuration keys based on the schema and current file contents.

src/cli/config · high confidence

New \`mise dot history\` command for browsing dotfile checkpoints

Users can now inspect the history of tracked dotfiles using the new \mise dot history\ command. This feature provides a checkpoint browser with subcommands to list recent changes (\ls\), view detailed checkpoint information including triggers and file changes (\show\), compare differences between checkpoints or against the current working tree (\diff\), and annotate checkpoints with custom descriptions (\describe\).

src/cli/dotfiles/history · high confidence

New \`mise dot\` command suite for managing dotfiles and history

A new \mise dot\ subcommand is introduced to manage dotfiles and their history. This suite includes commands to add, apply, edit, diff, and track files (\add\, \apply\, \edit\, \diff\, \track\), as well as to manage history checkpoints (\save\, \status\, \history\), synchronization with a remote repository (\origin\, \sync\, \pull\, \conflicts\), and file exclusions (\exclude\, \include\). The implementation also adds a background watcher service to automatically capture file changes and supports encrypted file storage. Also in this area: Fix relative path resolution for the --source argument in dotfiles add; Improved diagnostic accuracy and self-update safety in CLI; Dotfiles status reports unselected tracked entries.

src/cli/dotfiles · high confidence

New \`mise generate\` subcommands for project scaffolding

The \mise generate\ command now includes dedicated subcommands to scaffold common project files: \config\ generates a mise configuration file (wrapping the interactive editor), \devcontainer\ creates a \.devcontainer/devcontainer.json\ for VS Code remote environments, \git-pre-commit\ installs a pre-commit hook that runs mise tasks, \github-action\ generates a CI workflow file, \install-script\ (renamed from \bootstrap\) produces a self-contained mise installer script with optional Windows launchers, \task-docs\ renders task documentation into Markdown, \task-stubs\ creates executable shims for running tasks locally, and \tool-stub\ generates stubs for downloading and running external tools. These commands replace the previous experimental or scattered generation capabilities with a unified, documented interface.

src/cli/generate · high confidence

New \`mise installs\` subcommands to manage identity-layout installations

An experimental \mise installs\ command group is introduced to inspect and manage installations under the new identity install layout. It includes \mise installs ls\ to list all installations with their status (selected, pinned, or shared), \mise installs select\ to choose which installation is used for requests without a lockfile, and \mise installs migrate\ to move legacy installations into the identity layout structure. These commands allow users to handle multiple installations of the same version and transition from the previous layout.

src/cli/installs · high confidence

Developers can now use \mise plugins link \<name\> \<path\>\ to symlink a local plugin directory into mise, allowing edits in the source directory to take effect without reinstalling the plugin. This new command, located in \src/cli/plugins/link.rs\, creates a symlink in the plugins directory and supports an optional \--force\ flag to overwrite existing links. The command infers the plugin name from the directory path by stripping common prefixes like \mise-\, \vfox-\, or \asdf-\.

src/cli/plugins · high confidence

New \`mise skills\` command to list and sync agent skills from tools

A new \mise skills\ subcommand is introduced to manage agent skills declared by tools installed via the \packslip:\ backend. The \mise skills ls\ command lists the skills active in the current directory, showing the skill name, tool, version, and path, and warns if a declared skill is missing from disk. The \mise skills sync\ command creates symlinks for these skills into a target directory (defaulting to \.claude/skills\ in the project root or a global location), supporting options to specify a custom directory, use a global path, or prune obsolete links. This allows agents to automatically access the correct version of tool-specific skills.

src/cli/skills · high confidence

New \`mise sync\` command to integrate external version managers

A new \mise sync\ command has been added to synchronize tool versions from external managers into mise. The command supports syncing Node.js versions from nvm, nodenv, and Homebrew (\mise sync node\), Python versions from pyenv and uv (\mise sync python\), and Ruby versions from Homebrew (\mise sync ruby\). This allows users to make existing installations from other tools available to mise without reinstalling them.

src/cli/sync · high confidence

New \`mise tasks\` subcommands for task management and inspection

The \src/cli/tasks\ module has been restructured into dedicated subcommand files, introducing \mise tasks add\ to create new tasks (either as TOML entries or executable scripts), \mise tasks edit\ to open task definitions in an editor, \mise tasks deps\ to visualize dependency trees (with compact and DOT output modes), \mise tasks graph\ to inspect the workspace project graph, \mise tasks info\ to display detailed task metadata, and \mise tasks validate\ to check for configuration errors and circular dependencies. These changes provide a more granular and user-friendly interface for managing, inspecting, and validating tasks within the CLI.

src/cli/tasks · high confidence

New \`mise token\` command to inspect and manage authentication tokens

A new \mise token\ command has been added to help users debug authentication issues by displaying which token source is being used for Git providers. It supports subcommands for GitHub, GitLab, and Forgejo, showing the masked token and its source (e.g., environment variable, OAuth). The GitHub subcommand includes additional capabilities: a \--oauth\ flag to resolve tokens specifically via the native OAuth source, a \--refresh\ flag to mint a fresh OAuth token, a \--raw\ flag to output only the token value, and a hidden \--git-credential\ mode to supply tokens to Git's credential helper protocol.

src/cli/token · high confidence

New argument types for backends, tools, and environment variables

The CLI now uses dedicated argument types (BackendArg, ToolArg, EnvVarArg) to parse and validate tool and backend specifications. This enables more robust handling of backend identifiers (including full paths like 'aqua:oven-sh/bun'), inline options in brackets, and version prefixes (ref, tag, branch, path). Users benefit from clearer parsing of tool specifications and improved support for complex backend configurations. Also in this area: Fix OCI image packaging and backend switch warnings for aliased tools; Security hardening for registry URLs, lockfile paths, and environment variables.

src/args · high confidence

New cache management subcommands

The CLI now includes a \mise cache\ command group with four subcommands: \clear\ removes cache files for specific tools or all caches (including environment and task caches), optionally marking files as old via a hidden \--outdate\ flag; \prune\ removes stale cache files based on age settings, with support for dry-run and verbose modes; \path\ displays the current cache directory location; and \task\ inspects output cache entries for specific tasks, displaying details like size, time saved, and outputs in a table or JSON format.

src/cli/cache · high confidence

New core plugins for Bun, Deno, .NET, Elixir, Erlang, Go, and Java

The core plugin system now includes native backends for Bun, Deno, .NET, Elixir, Erlang, Go, and Java. These plugins allow you to install and manage these runtimes directly through mise without relying on external tools like asdf or pyenv. The Bun plugin handles Windows ARM64 and creates the bunx shim automatically. The Deno plugin fetches versions from the official deno.com API. The .NET plugin supports isolated installs and runtime-only modes. The Elixir and Erlang plugins use precompiled binaries where available and handle checksum verification. The Go plugin respects GOROOT and GOPATH settings and installs default packages. The Java plugin supports multiple vendors, release types, and uses a metadata API for version listing.

src/plugins/core · high confidence

New crate for detecting AI coding agents via environment variables

The \mise-agent-env\ crate has been added to detect whether a command is running under an AI coding agent by inspecting environment variables alone, without spawning subprocesses or accessing the filesystem. It provides \detect()\ and \is\_agent()\ functions that identify specific agents (such as Cursor, Claude Code, GitHub Copilot, and Codex) based on known environment signals, and includes a \detect\_with\_env()\ helper for testing or custom environment lookups.

crates/mise-agent-env · high confidence

New crate for parsing Homebrew formula and cask metadata

A new \mise-brew-metadata\ crate has been added to provide structured models and parsers for Homebrew formula and cask metadata. It extracts and parses formula details (such as versions, dependencies, and bottle specifications) and cask artifacts (including apps, binaries, and installation steps), enabling mise to accurately interpret Homebrew package definitions for installation and management.

crates/mise-brew-metadata · high confidence

New daemon presets for CockroachDB, NATS, PostgreSQL, Redis, and SpiceDB

The mise-daemons crate now ships with built-in presets for CockroachDB, NATS, PostgreSQL, Redis, and SpiceDB, allowing users to run these services as managed daemons with minimal configuration. Each preset defines the binary, default ports, version detection patterns, and initialization steps (such as database creation or schema migration). The system also introduces a deterministic port allocation mechanism for linked git worktrees, ensuring that daemons in different checkouts of the same project use distinct, non-conflicting ports while preserving the base port for the primary checkout. Additionally, a provider system is included for managing shared, user-owned instances of PostgreSQL, CockroachDB, and NATS.

crates/mise-daemons · high confidence

New dependency providers for aube, Bun, Dart/Flutter, Deno, and Git submodules

The dependency management system now includes built-in providers for aube (aube-lock.yaml), Bun (bun.lockb/bun.lock), Dart and Flutter (pubspec.yaml/lock), Deno (deno.lock), and Git submodules (.gitmodules). These additions allow the tool to automatically detect and manage dependencies in projects using these ecosystems, handling installation, package addition/removal, and freshness checks via their respective lockfiles and output directories.

src/deps/providers · high confidence

New developer tasks for linting, release automation, and CI resilience

This update introduces several new scripts in the xtasks directory to streamline development and release workflows. A new \fetch-gpg-keys\ task automates the collection of Node.js and Swift release keys into the \mise-util\ assets, replacing manual or fragmented fetching. Linting is consolidated via new \lint-fix.sh\ and \lint-fix.ps1\ scripts that wrap the \hk\ linter and Rust tooling, ensuring consistent code formatting across platforms. The \release-plz\ script is expanded to handle complex release logic, including idempotent publishing, subcrate version synchronization, and preventing duplicate GitHub Actions dispatches. Additionally, a new \test-tool-retry\ script adds resilience to CI by automatically retrying failed tool tests and applying a 7-day grace period for recent upstream releases, reducing false positives from transient upstream issues.

xtasks · high confidence

New diagnostic checks and command wrappers in configuration

The configuration module now supports \mise doctor\ checks defined in \.miserc.toml\ or \mise.toml\, allowing users to run custom diagnostic commands with platform-specific constraints and timeouts. Additionally, a new \command\_wrapper\ feature enables intercepting binary dispatch (e.g., wrapping \cargo\ via \mr-boxington\) with custom commands, arguments, and environment variables, controlled by the \mr\_boxington\ tool option.

src/config · high confidence

New embedded vfox plugins for 1Password, Android SDK, and more

This change embeds a suite of new vfox plugins directly into the tool, including support for 1Password CLI, aapt2, the Silver Searcher (ag), Android SDK command-line tools, Apache Ant, AsciidoctorJ, Azure Functions Core Tools, bfs, and bpkg. These plugins allow users to install and manage these specific tools via vfox without relying on external plugin sources. The implementation includes hooks for fetching available versions from their respective sources (GitHub, Maven, AgileBits), downloading the correct binaries or source code for the user's OS and architecture, and performing post-installation steps such as extracting archives, compiling from source (for ag and bfs), or setting up environment variables like ANDROID\_HOME and PATH.

crates/vfox/embedded-plugins · high confidence

New interactive TOML configuration editor

Users can now launch \mise edit\ to interactively view and modify their configuration file using a terminal-based interface. This new crate provides a navigable, menu-like experience where the TOML structure itself serves as the UI, allowing users to browse sections (such as tools, env, tasks, and settings), edit values inline, and add new entries via fuzzy-searchable pickers. The editor preserves comments and formatting, supports cursor navigation that skips non-editable comment lines, and includes built-in providers for tool registries and version selection, making configuration management more intuitive than manual text editing.

crates/mise-interactive-config/src · high confidence

New internal crate for Homebrew bottle relocation

A new internal crate, \mise-brew-relocation\, has been introduced to handle the rewriting of Homebrew bottle paths during installation. This component replaces placeholder strings (such as \@@HOMEBREW\_PREFIX@@\) with actual installation paths in text files, Mach-O binaries (on macOS), and ELF binaries (on Linux). It specifically manages complex scenarios like growing ELF interpreter and rpath strings by appending new program headers, and handles Mach-O load command growth by utilizing padding. The crate also supports shebang-only replacement for binary-backed text executables (like zipapps) to preserve payload integrity and tracks modified Mach-O files for subsequent codesigning.

crates/mise-brew-relocation · high confidence

New internal mise direnv integration commands

Added a new \mise direnv\ subcommand group containing \activate\, \envrc\, and \exec\ to facilitate integration with direnv. The \activate\ command outputs a shell function that allows mise to manage environment variables within direnv, while \envrc\ generates a temporary \.envrc\ file containing the current toolset's environment variables and watched config files. The \exec\ command runs a user command with the mise-managed environment and direnv watches applied. These commands are hidden from standard help and are intended for internal use to bridge mise's tool management with direnv's environment loading.

src/cli/direnv · high confidence

New mise-config crate centralizes configuration parsing and schema generation

The mise-config crate has been introduced to consolidate the parsing of mise.toml sections and the generation of their JSON schemas. This change moves configuration declarations for tools, aliases, environment variables, tasks, hooks, daemons, bootstrap settings, and doctor checks into this single location. By deriving schemas from Rust declaration types, the crate ensures that editor autocomplete and validation reflect the actual supported configuration shapes, while also handling deprecation warnings for legacy syntaxes.

crates/mise-config · high confidence

New mise-system crate consolidates bootstrap, dotfiles, and system management

The \mise-system\ crate has been introduced to centralize system-level operations previously scattered across the codebase. This new module manages declarative bootstrap tasks—including installing packages via system package managers, configuring Docker Compose projects, managing Linux user/group accounts, and applying macOS defaults and Dock settings. It also handles dotfile synchronization, supporting directory groups, templating, and history tracking. A build script now compiles and codesigns a macOS notification helper, and the crate provides capability detection for plugin system dependencies.

crates/mise-system · high confidence

New mise-ui crate consolidates UI, progress, and privilege-escalation logic

The new \mise-ui\ crate centralizes user-facing components previously scattered across the codebase. It introduces platform-specific Ctrl-C handling (\ctrlc.rs\/\ctrlc\_windows.rs\) to keep the process alive and manage child termination consistently. A new \install\_progress\ module provides a unified model and dual renderers (TTY and text) for tracking tool installations, resolutions, and removals. Interactive prompts (\prompt.rs\) now use a \Confirmation\ enum to safely distinguish between user refusal, unanswered prompts, and unavailable contexts. The \sudo\ module manages privilege escalation, suspending the progress display during password prompts and supporting \sudo\, \run0\, and \doas\. Additionally, the crate includes table rendering (\table.rs\) and theme selection (\theme.rs\) for interactive elements.

crates/mise-ui · high confidence

New modular task file providers for local, Git, and HTTP sources

The task system now uses a pluggable provider architecture to resolve task files from local paths, remote Git repositories, and HTTP URLs. This change introduces dedicated providers for each source type, enabling features such as caching for remote Git and HTTP tasks, automatic cleanup of temporary artifacts, and path validation to ensure remote Git files remain within their checked-out directories. Users benefit from more robust handling of remote task includes, including support for Azure DevOps SSH URLs and remote subdirectories, as well as improved performance and stability through caching and race-condition fixes.

_src/task/task\_file\providers · high confidence

New release, build, and testing scripts for mise

This change introduces a suite of new shell and PowerShell scripts to the \scripts/\ directory, enhancing the release pipeline, build optimization, and testing infrastructure. Key additions include \pgo.bash\ and \bolt.bash\ for Profile-Guided Optimization and LLVM BOLT binary reordering to improve startup performance, and \check-glibc.sh\ to enforce Linux binary compatibility by validating glibc and libstdc++ dependencies. The release workflow is supported by \publish-s3.sh\, \publish-r2.sh\, and \publish-version.sh\ for uploading assets to Cloudflare R2/S3 and managing CDN cache purges, while \render-mise-run.sh\ generates shell-specific installation scripts. Additionally, \test-check-glibc.sh\ and \task-cache-remote-compat.sh\ add unit and conformance tests for the new compatibility checks and remote task caching protocol, and \smoke-test-vfox-lua-error.ps1\ addresses Windows-specific Lua error handling in release builds.

scripts · high confidence

New shell installation script for mise.run

Added a new shell script (shell.envsubst) that automates the installation and shell activation of mise. The script downloads and installs mise using curl or wget, then configures the appropriate shell initialization file (bash, zsh, or fish) to activate mise, providing clear feedback and verification steps for the user.

packaging/mise.run · high confidence

New vfox plugin hook interface and context types

The vfox plugin system now exposes a comprehensive set of Rust-side hook implementations (available, backend\_exec\_env, backend\_install, backend\_list\_tools, backend\_list\_versions, backend\_search\_tools, backend\_tools, backend\_uninstall, env\_keys, mise\_env, mise\_install\_satisfied, mise\_path, package, parse\_legacy\_file, post\_install, pre\_install, pre\_uninstall) that define the context structures and Lua serialization logic for plugin interactions. This adds support for advanced plugin capabilities including tool discovery and search, rolling release version tracking with checksums, package manager plugin support (install/upgrade/uninstall), attestation metadata verification (GitHub, SLSA, Cosign) during pre-install, environment variable redaction, and install-state satisfaction checks, while also integrating legacy file parsing into the backend.

crates/vfox/src/hooks · high confidence

OpenTelemetry integration for task runs and logs

Users can now export OpenTelemetry traces and logs for \mise run\ tasks. Traces are enabled by setting \otel.enabled = true\ (or \MISE\_OTEL\_ENABLED=1\) and configuring a traces endpoint; logs are enabled separately via \otel.logs = true\ (or \MISE\_OTEL\_LOGS=1\) and a logs endpoint. Task stdout and stderr are forwarded as log records correlated with the task's trace context, with stderr mapped to WARN severity. Nested \mise run\ invocations automatically coordinate to avoid duplicate log exports by claiming the output stream.

src/otel · high confidence

Private PyPI index authentication via system keyring

Users can now authenticate against private PyPI indexes that require a username and password by storing credentials in the system keyring. The backend automatically retrieves the password using the \keyring\ executable (when configured as the provider) and attaches it as a Basic Authorization header during lock and version listing operations, removing the need to embed secrets in configuration files.

src/backend/pipx · high confidence

Support for corepack-compatible package manager checksums in package.json

The idiomatic version parser now reads package manager versions and checksums from package.json files, supporting both the standard packageManager field and the devEngines.packageManager field. It handles corepack-compatible version strings that include checksums (e.g., npm@10.0.0+sha512...), automatically configuring the backend to verify the downloaded package manager binary against the specified checksum. This enables automatic installation of specific package manager versions with integrity verification when using idiomatic version files.

_src/config/config\_file/idiomatic\version · high confidence

Removals

Removal of .bin/rtx shim script

The .bin/rtx shell script, which previously invoked cargo to build and run the chim tool, has been removed from the repository.

.bin · high confidence

Removal of legacy CLI argument modules

The \log\_level\ and \runtime\ argument modules have been removed from the CLI argument definitions. This eliminates the previous implementation for the \--log-level\ flag and the \RuntimeArg\ parser (used for parsing \plugin@version\ syntax), indicating a shift in how these specific configuration and input patterns are handled within the application.

src/cli/args · high confidence

Removal of legacy Homebrew formula for rtx

The Homebrew packaging file for the \rtx\ runtime manager has been deleted. This change removes the specific Homebrew formula that previously handled the installation and verification of the \rtx\ binary across macOS and Linux architectures, indicating a shift away from this specific packaging method or a consolidation of release assets.

packaging/homebrew · high confidence

Removal of legacy alias management CLI commands

The \alias\ and \aliases\ CLI commands (including the \ls\ subcommand) have been removed from the tool. Users can no longer list or manage aliases via the command line interface using these commands.

src/cli/alias · high confidence

Removed e2e tests for Node.js version switching

The end-to-end test suite for directory-based Node.js version switching has been removed. This includes the deletion of the \test\_bash\, \test\_fish\, and \test\_zsh\ scripts, as well as the associated \.tool-versions\ files for Node.js 16 and 18, which previously verified that the tool correctly activated different Node.js versions when changing directories.

e2e/cd · high confidence

Security

OCI build security hardening and layer assembly improvements

The OCI build process now includes stricter security measures to prevent sandbox escapes and protect sensitive data. Symlink-based path traversal is rejected during OCI whiteout application and transient cleanup (e.g., apt cache clearing) to prevent deletion of files outside the container rootfs. Additionally, OCI whiteouts are now restricted to single-component targets, preventing accidental deletion of parent directories. The \build\_layer\_from\_sources\ function allows assembling layers from multiple host paths and symlinks, enabling more flexible toolchain packaging. HTTP responses and downloads are now bounded in size and time to prevent resource exhaustion. Also in this area: Preserve absolute symlink targets in system package layers.

crates/mise-oci · high confidence

Architecture

Consolidated utility crate for shared infrastructure

The mise-util crate has been established as the central location for shared infrastructure, consolidating previously scattered modules including HTTP clients, Git helpers, file and path utilities, process execution, environment management, sandboxing, GPG signature verification, Tera templating, and remote source handling. This refactoring centralizes core capabilities such as command execution with bounded output, Ctrl+C group handling on Windows, age-based encryption, and cache management into a single, reusable crate. Also in this area: Fixes for Windows process cleanup, netrc parsing, and platform targeting; Hardened provenance verification and credential redaction.

crates/mise-util · high confidence

Daemon configuration and lifecycle are now managed by the mise-daemons crate

The daemon subsystem has been refactored to move daemon declarations, ports, presets, and runtime logic into the dedicated \mise-daemons\ crate. This location now provides the integration glue that resolves and installs project tools for daemons, manages the shell activation hook for automatic lifecycle, and handles task-to-daemon dependencies. Users benefit from a cleaner separation of concerns where the core \mise\ module delegates daemon-specific behavior to this new library, while retaining the same configuration syntax and command-line interface.

src/daemons · high confidence

New mise-system-packages crate for system package management

The system package manager implementations (apk, apt, aur, brew, etc.) have been moved into a new \mise-system-packages\ crate. This refactoring centralizes the logic for managing system-level packages across different operating systems and package managers, providing a unified interface for installation, upgrade, and status checking of system packages.

crates/mise-system-packages · high confidence

Refactored environment directive system into modular components

The environment directive handling in \src/config/env\_directive\ has been restructured from a monolithic implementation into distinct modules (\file\, \module\, \path\, \source\, \venv\). This change introduces a unified \EnvDirective\ enum that explicitly supports various directive types including key-value pairs, file loading (JSON, YAML, TOML, dotenv), path manipulation, shell script sourcing, and Python virtual environment creation. The refactoring centralizes directive resolution logic, improves cache invalidation tracking for plugins, and ensures consistent handling of environment variable expansion and redaction across all directive types.

_src/config/env\directive · high confidence

Refactored toolset resolution and installation into modular components

The toolset management logic in \src/toolset\ has been reorganized into distinct modules to improve clarity and maintainability. A new \ToolsetBuilder\ now handles the construction of toolsets from configuration, environment variables, and CLI arguments, supporting scoped resolution (local vs. global). Environment variable caching is now managed by a dedicated \env\_cache\ module that uses encrypted storage and file-mtime validation to ensure cache validity. Installation prerequisites are validated via a new \helpers\ module that checks for plugin-declared system dependencies before installation begins. Additionally, \install\_options\ centralizes configuration for installation behavior (such as parallelism and dry-run modes), while \install\_state\ consolidates the tracking of installed tools and their metadata into a unified manifest file.

src/toolset · high confidence

Refactored vfox backend into modular operation files

The vfox backend implementation has been reorganized from a single monolithic file into separate modules for backend operations, hooks, and installation logic. This structural change improves code maintainability and separation of concerns without altering the external behavior of the vfox integration.

crates/vfox/src/vfox · high confidence

Task execution engine refactored into modular components

The task execution logic has been reorganized into distinct modules to improve maintainability and separation of concerns. This change introduces a dedicated dependency graph manager (\deps.rs\) for handling task ordering and cycle detection, a comprehensive caching system (\task\_cache.rs\, \task\_cache\_store.rs\, \task\_cache\_audit.rs\) supporting local and remote storage with integrity verification, and a new confirmation dialog system (\task\_confirm.rs\). Additionally, environment and toolset resolution for tasks is now handled by a specialized builder (\task\_context\_builder.rs\) that optimizes caching for monorepo scenarios.

src/task · high confidence

Behavioural changes

Added mise shell activation for Fish

The system now includes a configuration file for the Fish shell that automatically activates mise (a tool version manager) if the MISE\_FISH\_AUTO\_ACTIVATE environment variable is not set to 0. This replaces previous rtx integration with mise-specific activation logic.

share · high confidence

Aqua registry support now uses a baked-in snapshot with custom registry and offline capabilities

The Aqua integration has been refactored to support a baked-in registry snapshot compiled into the binary, which can be used as a fallback or primary source. Users can now configure multiple custom registries via settings, and the system respects the \prefer\_offline\ and \MISE\_OFFLINE\ modes by skipping network calls when tools are uninstalled or when the baked registry is preferred. The baked registry includes platform-specific backend overrides (e.g., Go vs. Cargo) and libc variants, ensuring accurate package resolution without requiring a live download of the aqua-registry repository in all cases.

src/aqua · high confidence

Aqua validation and test refactoring

The aqua backend now includes explicit validation logic that rejects packages marked with \no\_asset\ in the registry, ensuring users are notified when a specific version lacks a downloadable asset. Additionally, the fuzzy version matching logic has been refactored and verified against its previous regex-based implementation to ensure behavioral consistency, while also ensuring that error messages for cargo-type packages correctly suggest the appropriate backend and safely escape terminal control characters.

src/backend/aqua · medium confidence

Automated reshimming for Node.js npm and Ruby gem installations

The tool now automatically updates its executable shims after global package installations or uninstallations for both Node.js and Ruby. For Node.js, a new npm wrapper script intercepts global install, uninstall, and link commands to trigger a reshim operation, ensuring that newly installed or removed binaries are immediately available in the PATH. For Ruby, a new plugin script sets the PKG\_CONFIG\_PATH to help native gem extensions find necessary headers and libraries, and hooks into the gem and Bundler install/uninstall processes to automatically reshim, keeping the environment consistent after package changes.

src/plugins/core/assets · high confidence

CLI argument parsing engine replaced with usage-rs

The command-line interface now uses the \usage-rs\ library instead of \clap\ for parsing arguments and generating help text. This change updates the underlying CLI framework, which may affect how flags and subcommands are processed and displayed, while maintaining the existing command structure for users.

src/cli · high confidence

Config file parsing refactored with improved diagnostics and template support

The config file handling has been restructured to improve error reporting and template capabilities. TOML parsing errors now provide rich, context-aware diagnostics using miette, including specific help text for common Windows path issues. The legacy \.rtxrc\ and \legacy\_version\ file parsers have been removed in favor of the unified \mise.toml\ and \.tool-versions\ formats. Template rendering (Tera) is now supported in \.tool-versions\ files, requiring trust checks when templates are detected. Additionally, a new \config\_root\ module provides robust logic for determining project roots across various config file locations (e.g., \.mise/\, \.config/mise/\, \conf.d/\), and a \min\_version\ module enforces hard and soft version constraints on config files.

_src/config/config\file · high confidence

Deprecation of \`mise github\` command in favor of \`mise token github\`

The \mise github\ command is now deprecated and will be removed in version 2027.5.0; users should migrate to \mise token github\. The new \github\ subcommand in the CLI module now delegates to the token management system, displaying the GitHub token source and value (with options to unmask, show raw output, or force a native OAuth refresh) for debugging authentication issues.

src/cli/github · high confidence

E2E test harness rewritten for isolation, parallelism, and portability

The end-to-end test infrastructure has been completely overhauled to improve reliability and speed. The new harness enforces strict environment isolation by creating temporary, sandboxed directories for each test, preventing cross-test pollution. It introduces parallel execution with configurable concurrency (E2E\_JOBS) and supports retry logic for flaky tests. The runner is now portable across different shells (bash, zsh, fish) and operating systems, including specific workarounds for macOS path limits and older bash versions. Additionally, the test runner integrates with CI systems via GitHub Actions annotations and step summaries, and provides better timeout handling and performance warnings for slow tests.

e2e · high confidence

Improved macOS universal binary and version constraint handling

The registry now correctly resolves binaries in macOS universal archives by checking for universal asset paths alongside per-architecture ones, preventing installation failures for packages like fastfetch. Additionally, the \semver()\ constraint parser now supports the \!=\ operator and correctly handles version strings with more than three components (e.g., \5.34.1.0\), ensuring that version overrides and filters match as intended.

crates/aqua-registry/src/types · high confidence

Introduce dedicated dotenv parsing crate with shell-like quoting and file-scoped substitution

Mise now uses a new, vendored \mise-dotenv\ crate (derived from \dotenv-ng-core\ 1.0.0) to parse \.env\ files. This change improves how values are interpreted: adjacent quoted and unquoted parts are now joined with quotes removed (e.g., \'it'\\''s'\ becomes \it's\), backslashes inside single-quoted values are kept literal, and values ending in escaped whitespace are left unquoted. Additionally, variable substitution (\${VAR}\) resolves against the file's own assignments before checking ambient environment variables, preventing process environment values from shadowing file-defined ones. The crate also adds robust error reporting for parse and I/O issues, case-insensitive key handling on Windows, and a rendering API for stable \.env\ output.

crates/mise-dotenv · high confidence

Native Windows shim replaces shell-based launcher

The mise shim on Windows is now a native executable rather than a shell script wrapper. This change delivers Windows launcher arguments intact, prevents infinite recursion when the shim directory is filtered, and allows the shim to correctly detect and execute task stubs located beside the executable. Users benefit from more reliable argument passing and robust handling of task stubs on Windows.

crates/mise-shim · high confidence

Native dependency graphs stored in sidecar files

Lockfile generation now stores Python (uv.lock) and npm (package.json) dependency graphs in separate sidecar files alongside the lockfile, rather than embedding them inline. This change improves performance by avoiding redundant graph generation and ensures cross-platform consistency by normalizing line endings before hashing, which prevents digest mismatches on Windows. The system automatically migrates existing inline graphs to this new sidecar format on the next save. Also in this area: Fix lockfile generation for OS-excluded tools and symlinked config directories; Security hardening for registry URLs, lockfile paths, and environment variables; Template-aware platform keys and lockfile variants for HTTP artifacts.

src/lockfile · high confidence

New \`mise deps\` command for project dependency management

The \mise prepare\ command has been renamed to \mise deps\ and now provides a dedicated interface for managing project dependencies (such as \node\_modules\) separately from versioned tools. This new command supports adding (\add\), removing (\remove\), and installing (\install\) packages using an ecosystem-specific provider model (e.g., \npm:react\). It introduces features like dry-run mode, force reinstall, monorepo support, and the ability to explain why a provider is considered fresh or stale, allowing users to manage dependencies via a structured \ecosystem:package\ syntax.

src/cli/deps · high confidence

Opt-in identity-based installation layout

Users can now opt into a new installation layout (\install\_layout = "identity"\) that stores tools in directories named by a stable hash of the request (e.g., \\<label\>-\<hash\>\) rather than the version string. This layout, gated behind the \experimental\ flag, uses a catalog to track installations, receipts, and selections, ensuring paths remain stable even after pruning or when multiple versions of the same tool are installed. It also supports migrating legacy installations into this new structure and improves \mise prune\ by snapshotting templated version resolutions to accurately determine which installations can be safely removed.

_src/install\layout · high confidence

RPM packaging migrated from rtx to mise

The RPM build infrastructure has been renamed from rtx to mise, replacing the old rtx.spec and rtx.repo files with new mise.spec and mise.repo definitions. The package now installs the mise binary and its man page, and the GPG signing key has been updated to a new identifier.

packaging/rpm · high confidence

Rebranding of Debian packaging to 'mise' and shell script modernization

The Debian package generation process has been updated to reflect the project's rebranding from 'RTX' to 'mise', updating repository metadata (Origin, Label, Description) and the maintainer label in the Dockerfile. Additionally, the \generate-release.sh\ script has been modernized by switching the interpreter from \sh\ to \bash\, enabling stricter error handling with \set -euo pipefail\, and adding shellcheck directives to improve script reliability and maintainability.

packaging/deb · high confidence

Redesigned interactive install progress and Ctrl-C handling

The \src/ui\ module has been refactored to replace the previous progress bar implementation with a new \clx\-based system. This introduces a unified install progress model (\install\_progress\) that renders either a live, animated terminal region (\tty\_install\_progress\) for interactive sessions or an append-only text log (\text\_install\_progress\) for CI and captured output. The new system features a dedicated header bar for the overall install, per-tool rows with dynamic layout adaptation, and weighted progress bars that account for post-install hooks. Additionally, Ctrl-C handling (\ctrlc\) has been rewritten to keep the application alive during interruption, allowing users to cancel specific tasks or the entire install gracefully, with platform-specific logic for Windows console events. Also in this area: Redaction of credentials in diagnostic and progress output.

src/ui · high confidence

Refactor CLI argument parsing to use usage-rs

The CLI argument parsing library has been replaced from clap to usage-rs. This change updates the underlying framework for defining and parsing command-line arguments, which may affect how help text is generated and how arguments are processed internally, though the external command interface remains consistent.

(repo-wide) · high confidence

Refactored settings management with dedicated subcommands and improved CLI parsing

The settings management commands have been restructured into dedicated subcommands (\add\, \get\, \ls\, \set\, \unset\) under \mise settings\, replacing the previous flat interface. This change introduces \mise settings add\ for appending values to array settings, \mise settings get\ for retrieving specific setting values, and \mise settings ls\ with enhanced output options including \--json-extended\ to show source paths. The \set\ command now strictly prevents writing to environment-only settings and correctly handles OS-specific path separators for list settings. Additionally, legacy \pipx\ settings are automatically migrated to \pypi\ during these operations.

src/cli/settings · high confidence

Removal of Husky pre-commit hook script

The pre-commit hook script located in the .husky directory has been deleted. This file previously executed linting and help rendering tasks via 'just' before commits, and its removal indicates that this specific pre-commit automation is no longer active in this location.

.husky · high confidence

Self-update now verifies release artifacts using GitHub repository ID

The self-update process now performs additional verification of mise's own release artifacts by checking the packslip against the specific GitHub repository ID (586920414) rather than just the repository name. This ensures that even if the repository is renamed or transferred to a different organization, the update mechanism continues to trust the correct source. The verification also confirms that the release was signed by the official release workflow and checks that the release has been recorded in the transparency log for a minimum period before it can be installed, adding a layer of security against rapid, potentially malicious releases.

_src/cli/self\update · high confidence

Settings validation and caching logic moved to mise-settings crate

The \mise-settings\ crate now owns the generated settings types and the process-wide cache, introducing validation for strict choice settings (such as \lockfile\_mode\, \status.missing\_tools\, and \windows\_shim\_mode\) to reject invalid values early, and implementing a generation-based cache that discards stale snapshots if settings are cleared or replaced during a concurrent load. Also in this area: Hardened provenance verification and credential redaction.

crates/mise-settings · high confidence

Shell completions now generated by the usage library

The shell completion scripts for Bash, Zsh, Fish, and PowerShell have been replaced with new versions generated by the \usage-argv\ tool. These scripts now invoke \mise \_\_complete\word\\_\ to provide dynamic completions, ensuring that command-line suggestions stay in sync with the tool's current help definitions and behavior.

completions · high confidence

Upgrade Tera templating engine to v2

The underlying Tera templating library has been upgraded from v1 to v2. This change affects all configuration files that use Tera syntax, such as mise.toml, .tool-versions, and .miserc.toml. Users should verify that their existing template expressions remain compatible with the v2 API, as the upgrade may introduce breaking changes to filter or function behavior.

src · high confidence

Validation added for registry tool project homepage URLs

A new validation function \is\_project\_url\ has been introduced in the build system to enforce stricter rules for the \url\ field in registry tool entries. This function ensures that project homepage URLs use \http://\ or \https://\ schemes, contain no whitespace, and exclude template placeholders like \{\ or \}\. This change prevents invalid or backend-specific download templates from being accepted as project homepages, ensuring consistency between the build-time registry and the floating registry.

build · high confidence

Vfox CLI restructured with new subcommands and usage-rs integration

The vfox CLI has been refactored to use the usage-rs library for argument parsing, replacing the previous clap-based implementation. This change introduces a new command structure with dedicated subcommands: 'available' to list available SDKs, 'env-keys' to retrieve environment variables for a specific SDK and version, 'install' to install an SDK version to a specified directory, and 'plugins' (aliased as 'plugin') to manage plugins, including a 'list' subcommand to display installed SDKs. The CLI module now orchestrates these commands through a unified entry point.

crates/vfox/src/cli · high confidence

Fixes

Fix \`cargo +nightly\` compatibility when using dated nightly toolchains

Users can now run \cargo +nightly\ reliably even when mise installs the nightly channel as a specific dated version (e.g., \nightly-2026-09-26\) for reproducibility. The new \nightly\_channel\ logic creates a synchronized copy of the dated toolchain under the \nightly\ alias, handling file reflinks, hardlinks, and metadata updates to ensure rustup's rolling \nightly\ toolchain remains usable without conflicting with mise's managed installations.

src/plugins/core/rust · high confidence

Prevents infinite shim fallback loops while allowing legitimate re-entries

The CLI shim now detects and stops infinite recursion in Unix \exec\ chains by tracking fallback handoffs via the \\_\_MISE\_SHIM\_FALLBACK\_CHAIN\ environment variable. It enforces a 32-entry limit for distinct handoffs and allows up to 8 repeats of the same handoff within a single process to accommodate legitimate scenarios (such as \bash -c\ re-invoking the shim), while rejecting further repeats as recursion. This prevents the CLI from hanging or crashing when misconfigured shims cause circular resolution, providing clear error messages to help users set correct versions or remove conflicting shims.

src/cli/shim · high confidence

Template engine now handles unterminated string literals

The template lexer has been fixed to correctly handle unterminated string literals, preventing parse errors in malformed template expressions. This change ensures that the template rendering engine is more robust when processing user-provided templates, particularly those involving string constants.

crates/aqua-registry/src/template · medium confidence

Test coverage

Add dummy vfox plugin for local testing; Add dummy vfox plugin hooks for testing; Add mutable PyPI test fixture for regression testing; Added Nix bootstrap test suite; Added Windows backend tests for aqua, HTTP, and GitHub tool installations; Added dummy plugin test fixtures; Added e2e tests for OCI image building, pushing, and layer caching; Added e2e tests for fnox secrets integration; Added e2e tests for task execution and caching; Added e2e tests for the aqua backend; Added end-to-end tests for NVM and Python (uv) sync operations; Added end-to-end tests for npm and pnpm override behavior; Added end-to-end tests for plugin management and backend capabilities; Added end-to-end tests for the generate command suite; Added end-to-end tests for tool filtering, path ordering, and runtime symlink migrations; Added regression test for node-gyp bootstrap trampoline; Added test fixture for plugin dependency validation; Added test fixture for signed vfox plugin packslip archives; Added test fixtures for environment variable handling and configuration schemas; Added test fixtures for vfox.rs; Added test stubs for the vfox-npm plugin; Added tests for deprecated mise direnv command warnings; E2E tests now use local HTTP and Git servers instead of external services; End-to-end tests for configuration behavior; End-to-end tests for shell activation and deactivation; Expanded Windows end-to-end test coverage for activation, bootstrap, and tool execution; Expanded e2e/core test coverage for idiomatic version files, lockfiles, and tool-specific behaviors; Expanded end-to-end test coverage for lockfile behavior; Expanded end-to-end testing for environment management; Local fake npm registry for e2e tests; Migration of test snapshots from rtx to mise; New e2e fixtures for bootstrap, GitHub OAuth, and self-update testing; New end-to-end tests for shell activation, shims, and hooks; Removal of CLI test snapshot files; Removed test fixture files in test/cwd; Test infrastructure updates: new test tool versions and gitignore rules; Updated configuration loading snapshot for mise integration; Updated shell activation and deactivation test snapshots; Updated snapshot for mise plugin TOML configuration; Updated test snapshots for mise.toml configuration parsing.

Dependencies

Routine dependency maintenance across Rust and JavaScript manifests

This release updates dependencies across 18 manifests, including routine lock-file maintenance and version bumps for Rust crates such as confique, age, aube-registry, aube, indexmap, bytes, log, base64, either, zip, ctrlc, curve25519-dalek, serde\_json, hyper-util, system-configuration, lru, aws-sdk, regex, strum, usage-lib, demand, chrono, sha2, clap, reqwest, tera, sigstore-verify, petgraph, junction, versions, rmp-serde, self\_update, aws-lc-rs, and clap\_complete. It also updates JavaScript dependencies including markdown-it, @tsconfig/node24, tar, and @types/node, alongside lock-file maintenance for various packages.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 63 → 62 (-1.1)

Lenses

  • Code Health 88 → 88 (+0.4)
  • Architecture 90 → 89 (-1.4)
  • Maturity 73 → 75 (+1.8)
  • Readiness 63 → 63 (+0.6)
  • Security 57 → 56 (-0.8)
  • Domain Modelling 100 → 100 (+0.0)
  • Accessibility 62 → 59 (-2.8)
  • Performance 100 → 85 (-15.0)

Resolved (572)

  • AccountAction::apply (cognitive 37) (src/system/accounts.rs)
  • AccountAction::apply (cyclomatic 25) (src/system/accounts.rs)
  • AptSource::parse (cognitive 20) (src/system/packages/apt_sources.rs)
  • BootstrapTomlConfig::merge_below (cognitive 25) (src/system/mod.rs)
  • BrewCaskManager::install_one_with_ancestors (cognitive 72) (src/system/packages/brew/cask/mod.rs)
  • BrewCaskManager::install_one_with_ancestors (cyclomatic 54) (src/system/packages/brew/cask/mod.rs)
  • BrewManager::install_via_pour (cognitive 85) (src/system/packages/brew/mod.rs)
  • BrewManager::install_via_pour (cyclomatic 40) (src/system/packages/brew/mod.rs)
  • CargoBackend::install_version_ (cognitive 27) (src/backend/cargo.rs)
  • CargoBackend::install_version_ (cyclomatic 22) (src/backend/cargo.rs)
  • Change coupling clique: install.rs, upgrade.rs, use.rs, mod.rs (src/cli/system/install.rs)
  • Change coupling: activate.rs ↔ deactivate.rs (src/cli/activate.rs)
  • Change coupling: add.rs ↔ status.rs (src/cli/dotfiles/add.rs)
  • Change coupling: bash.rs ↔ fish.rs (src/shell/bash.rs)
  • Change coupling: exec.rs ↔ shell.rs (src/cli/exec.rs)
  • Change coupling: install.rs ↔ update.rs (src/cli/plugins/install.rs)
  • Change coupling: ls.rs ↔ set.rs (src/cli/tool_alias/ls.rs)
  • Change coupling: set.rs ↔ unset.rs (src/cli/tool_alias/set.rs)
  • Change coupling: unuse.rs ↔ use.rs (src/cli/unuse.rs)
  • ClassTooLong: BrewCaskManager (src/system/packages/brew/cask/mod.rs)
  • …and 552 more

New (722)

  • AccountAction::apply (cognitive 37) (crates/mise-system/src/accounts.rs)
  • AccountAction::apply (cyclomatic 25) (crates/mise-system/src/accounts.rs)
  • Applying::adopt_history (cognitive 19) (crates/mise-system/src/history/sync/apply.rs)
  • Applying::check_planning_still_holds (cognitive 24) (crates/mise-system/src/history/sync/apply.rs)
  • Applying::protect_replaced_files (cognitive 18) (crates/mise-system/src/history/sync/apply.rs)
  • Applying::record_failure (cognitive 18) (crates/mise-system/src/history/sync/apply.rs)
  • AptSource::parse (cognitive 20) (crates/mise-system-packages/src/apt_sources.rs)
  • AquaBackend::resolve_validated_package (cognitive 16) (src/backend/aqua.rs)
  • Backend::latest_version_with_selection_options (cognitive 19) (src/backend/mod.rs)
  • BootstrapTomlConfig::merge_below (cognitive 26) (crates/mise-system/src/lib.rs)
  • BootstrapTomlConfig::merge_below (cyclomatic 17) (crates/mise-system/src/lib.rs)
  • Boundary-crossing change coupling: lib.rs ↔ install.rs (crates/mise-system-packages/src/lib.rs)
  • Boundary-crossing change coupling: lib.rs ↔ mod.rs (crates/mise-system-packages/src/lib.rs)
  • Boundary-crossing change coupling: lib.rs ↔ upgrade.rs (crates/mise-system-packages/src/lib.rs)
  • Boundary-crossing change coupling: resources.rs ↔ mod.rs (crates/mise-system/src/resources.rs)
  • BrewCaskManager::install_one_with_ancestors (cognitive 74) (crates/mise-system-packages/src/brew/cask/mod.rs)
  • BrewCaskManager::install_one_with_ancestors (cyclomatic 56) (crates/mise-system-packages/src/brew/cask/mod.rs)
  • BrewManager::install_via_pour (cognitive 85) (crates/mise-system-packages/src/brew/mod.rs)
  • BrewManager::install_via_pour (cyclomatic 40) (crates/mise-system-packages/src/brew/mod.rs)
  • CargoBackend::install_crate (cognitive 27) (src/backend/cargo.rs)
  • …and 702 more

Changes since last survey

  • 300 commits — 176 feature/other, 124 fixes

By area

  • (root) — 54 commits
  • crates/mise-config — 26 commits
  • src/backend — 22 commits
  • crates/mise-util — 21 commits
  • crates/mise-system — 15 commits
  • src/config — 13 commits
  • src/cli — 12 commits
  • .github/workflows — 11 commits
  • e2e/cli — 10 commits
  • crates/vfox — 8 commits
  • docs/dev-tools — 7 commits
  • crates/mise-lsp — 5 commits
  • e2e/backend — 5 commits
  • e2e/core — 5 commits
  • src/plugins — 5 commits
  • src/toolset — 5 commits
  • crates/mise-system-packages — 4 commits
  • docs/.vitepress — 4 commits
  • e2e/lockfile — 4 commits
  • src/system — 4 commits

Notable commits

  • fix: Revert "chore(deps): pin zipsign-api to 0.2.1"
  • fix: fix(activate): stop fish not-found recursion after mise implode (#14594)
  • fix: fix(aqua): date github_tag versions so minimum_release_age applies (#14691)
  • fix: fix(aqua): find binaries in macOS universal archives (#14665)
  • fix: fix(aqua): handle unterminated string literals in template lexer (#14752)
  • fix: fix(aqua): make the baked registry encoding deterministic (#14809)
  • fix: fix(backend): reuse cached conda downloads in locked installs (#14866)
  • fix: fix(backend): warn when minimum_release_age cannot check a version's date (#14694)
  • fix: fix(backends): name --global in the switch warning for global lock entries (#14976)
  • fix: fix(bootstrap): add list alias for packages status (#14709)
  • fix: fix(bootstrap): find a just-installed git outside startup PATH (#14919)
  • fix: fix(bootstrap): find nix installed by a pre-packages hook (#14596)
  • fix: fix(bootstrap): match only an exact bootstrap task (#14858)
  • fix: fix(bootstrap): parse [bootstrap.linux.firewall] on every OS (#14615)
  • fix: fix(bootstrap): pin compose service references before hashing (#14729)
  • fix: fix(bootstrap): pin full container ids when hashing compose service references (#14958)
  • fix: fix(bootstrap): render templates in bootstrap.user.login_shell (#14570)
  • fix: fix(brew): tolerate custom Requirement classes in tap formulae (#14807)
  • fix: fix(cargo): honor rename_exe for cargo-installed tools (#14626)
  • fix: fix(ci): install zipsign with --locked (#14551)
  • …and 280 more

Architecture

  • Unchanged — 0 containers · 2 contexts · 0 edges

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

jdx/mise was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 26 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit dec9ac6b3b2a68d8a3d9ebb7c7400cc2e22a7537 — the exact code this score is about.
  • Scored under rubric-2026.10.5 — the same rubric and the same method as every other entry in this index.
  • Measured by watchdog.canine.dev using codehealth-analyzer measure-2026.10.33+preprod-938cc7d20781.