install

Additional install commands

macOS

Homebrewverified · 100%

brew install ndenv

local Homebrew formula metadata

overview

Package summary

Node version manager

Project links

Commands and aliases

ndenv

history

Project history and usage

ndenv is Ryosuke Iwanaga's rbenv-style Node.js version manager. Its README describes it as similar to rbenv, able to manage multiple Node.js and io.js versions, and able to switch automatically using a per-project `.node-version` file.

Project history

The GitHub API reports the riywo/ndenv repository was created on June 20, 2013. The README says almost all of the code came from rbenv, making ndenv part of the wave of language runtime managers that copied rbenv's shim-and-version-file model into other ecosystems.

The project's own README marks ndenv deprecated, recommends nodenv, and says the repository is not maintained actively. Homebrew also marks the formula deprecated and lists August 24, 2026 as the disable date, with nodenv as the recommended replacement.

Adoption history

ndenv's practical adoption path was narrow but clear: developers who liked rbenv's automatic local version switching for Ruby could use a similar workflow for Node before nodenv, fnm, mise, asdf-nodejs, and other tools became common.

On July 1, 2026, Homebrew Formulae listed only 61 ndenv installs in its 365-day analytics window. That small number matches the upstream deprecation note and the ecosystem shift toward maintained replacements.

How it is used

The old workflow was to install ndenv, initialize shell integration, install node-build as the installer plugin, run commands such as `ndenv install v0.12.0`, and commit `.node-version` so entering a project directory selected the expected runtime.

The broader `.node-version` convention outlived ndenv. Independent compatibility research lists many tools that read `.node-version`, while noting that the file has no single formal standard.

Why package nerds care

ndenv matters less as a package to install than as a fossil in the version-manager lineage: rbenv semantics, Node/io.js era naming, node-build plugin dependency, and a clean migration story to nodenv.

Timeline

{'date': '2013-06-20', 'event': 'riywo/ndenv repository creation date reported by the GitHub API.'}
{'date': '2018-12-27', 'event': 'Last push date reported by the GitHub API for riywo/ndenv.'}
{'date': '2026-07-01', 'event': 'Homebrew Formulae listed ndenv as deprecated with 61 installs in the 365-day analytics window.'}
{'date': '2026-08-24', 'event': 'Homebrew Formulae listed this as the formula disable date.'}

Related projects

rbenv
node-build
nodenv
nvm
asdf-nodejs
mise
fnm

Sources

security posture

Risk level: orange

infrastructure mutation or orchestration signal.

Risk classifier

orange risk · medium confidence · infrastructure

Why

infrastructure mutation or orchestration signal

Signals

text:version manager

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 13 platform targets.
Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ./.node-version

executables

Installed executables

Command	Kind	Exposure	Note
`ndenv`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.4.0

manager updated2026-05-14

local dataok

upstreamcurrent

latest detectedv0.4.0

https://github.com/riywo/ndenv

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:ndenv
Version	0.4.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/ndenv
Homepage	https://github.com/riywo/ndenv
Repository	https://github.com/riywo/ndenv
Upstream docs	https://github.com/riywo/ndenv#readme
License	MIT
Source archive	https://github.com/riywo/ndenv/archive/refs/tags/v0.4.0.tar.gz
Last updated	2026-05-14T11:39:17-04:00
Pulse	updated
Dependencies	node-build
Bottle	available (on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	ndenv
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	yes
Disabled	no
Keg Only	no
URL Keys	head stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/ndenv.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
package relationship graph
package version freshness
package-page enrichment

Install ndenv with Homebrew