id = "nodebrew"
name = "nodebrew"
homepage = "https://github.com/hokaccha/nodebrew"
description = "Node.js version manager"
executables = ["nodebrew"]

[dotfiles]

# nodebrew's official README documents ~/.nodebrew as its default home and
# its source shows that the user-selected aliases are stored in an `alias`
# file below that directory. Installed Node trees and the current symlink are
# machine-specific, so only the portable alias file is carried.
# https://github.com/hokaccha/nodebrew
paths = ["~/.nodebrew/alias"]
secret = []

[commands]
format = 1
label = "Manage Node.js versions"
description = "Install or switch Node.js versions with nodebrew. Compile-from-source, aliases, clean, migrate-package and prune are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["install"]
label = "Install a version"
description = "Download and install a Node.js version from binary. Accepts v8.9.4, 8.9.4, v8.9, latest or stable."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/hokaccha/nodebrew#readme"
revision = "HEAD 2026-10-27"
evidence = """
### `nodebrew install <version>`
$ nodebrew install v8.9.4
$ nodebrew install latest # latest version
$ nodebrew install stable # stable version
"""

[[commands.subcommand.field]]
id = "version"
label = "Version"
type = "string"
position = 0
min = 1
suggestions = [{ value = "latest", label = "Latest" }, { value = "stable", label = "Stable" }]
sources = ["readme"]

[[commands.subcommand.task]]
id = "install"
label = "Install"
fields = ["version"]
required = ["version"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["version"]

[[commands.subcommand]]
path = ["use"]
label = "Switch active version"
description = "Make an installed Node.js version the current one."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/hokaccha/nodebrew#readme"
revision = "HEAD 2026-10-27"
evidence = """
### `nodebrew use <version>`
$ nodebrew use v8.9.4
$ nodebrew use latest # latest version
$ nodebrew use stable # stable version
"""

[[commands.subcommand.field]]
id = "version"
label = "Version"
type = "string"
position = 0
min = 1
suggestions = [{ value = "latest", label = "Latest" }, { value = "stable", label = "Stable" }]
sources = ["readme"]

[[commands.subcommand.task]]
id = "use"
label = "Use version"
fields = ["version"]
required = ["version"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["version"]