# Install ndenv with Homebrew

Node version manager. Version 0.4.0 via Homebrew; verified 2026-05-14.

## Install

```sh
sudo av install brew:ndenv
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ndenv
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:ndenv
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ndenv>
- **Version:** 0.4.0
- **Source summary:** Node version manager
- **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
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- ndenv (cli)
- ndenv (alias)

## Dependencies

- node-build

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-09
- Package-manager version: 0.4.0
- Package-manager updated: 2026-05-14
- Local data: ok
- Upstream repository: https://github.com/riywo/ndenv
- Upstream latest detected: v0.4.0 (current)
## 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

- <https://api.github.com/repos/riywo/ndenv>
- <https://formulae.brew.sh/formula/ndenv>
- <https://github.com/nodenv/nodenv/blob/main/README.md>
- <https://github.com/riywo/ndenv>
- <https://github.com/shadowspawn/node-version-usage/blob/main/README.md>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## 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

- Unix: ./.node-version
## 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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [node-build](https://www.automicvault.com/pkg/brew/node-build/) - Runtime dependency declared by Homebrew.
- [brew-php-switcher](https://www.automicvault.com/pkg/brew/brew-php-switcher/) - Shares av.db curated category or tags: cli, developer-tools, runtime-management.
- [fnm](https://www.automicvault.com/pkg/brew/fnm/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [nave](https://www.automicvault.com/pkg/brew/nave/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [nodebrew](https://www.automicvault.com/pkg/brew/nodebrew/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [nodenv](https://www.automicvault.com/pkg/brew/nodenv/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [vfox](https://www.automicvault.com/pkg/brew/vfox/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, runtime-management, version-manager.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, nodejs.

## Combined YAML source

View the package source record on GitHub. [combined/ndenv.yml](https://github.com/automic-vault/db/blob/main/combined/ndenv.yml)


## Sources

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