otty / apps

All apps/Volta

Volta

volta

Volta: JS Toolchains as Code. The Hassle-Free JavaScript Tool Manager.

Runs as volta|macOS, Linux, Windows|volta.sh

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Volta in your home directory Every rule on this page, by file

· hooks.json Sync

· tools/user/platform.json Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/volta/otty.tomlThe file this page is generated from

id = "volta"

name = "Volta"

homepage = "https://volta.sh"

description = "Volta: JS Toolchains as Code. The Hassle-Free JavaScript Tool Manager."

# The V-and-coils mark from Volta's own assets repository — the same mark

# the wordmark is built around, on its own so it reads at icon size.

icon = "https://raw.githubusercontent.com/volta-cli/assets/main/concepts/tesla-coil/two-coils-straightened-v-only-350x350.png"

executables = ["volta"]

[dotfiles]

# https://docs.volta.sh/advanced/hooks — "Hooks specified in the Volta

# directory (~/.volta/hooks.json on Linux/MacOS, %LOCALAPPDATA%\Volta\hooks.json

# on Windows) will apply across the entire system"; a project's own

# <PROJECT ROOT>/.volta/hooks.json is not user-level and is not listed.

# crates/volta-layout/src/v3.rs spells out the rest of that directory:

# "cache"/ "bin"/ "log"/ "tmp"/ state, shims and downloads

# "tools"/ "inventory"/ "image"/ "shared"/ installed toolchains

# "tools"/"user"/"platform.json" the default toolchain

# "hooks.json" the hooks file above

# "layout.v3" the layout marker

# platform.json is what `volta install node@22` pins — the user's default

# toolchain, the same kind of fact as asdf's ~/.tool-versions — so it is listed

# beside hooks.json. Everything else is an install or a cache and is left out

# by naming the two files rather than the directory.

paths = [

"~/.volta/hooks.json",

"~/.volta/tools/user/platform.json",

"%LOCALAPPDATA%/Volta/hooks.json",

"%LOCALAPPDATA%/Volta/tools/user/platform.json",

]

exclude = []

# Hooks name registry URLs and templates; platform.json names version numbers.

# Neither authenticates anything — Volta downloads from public registries.

secret = []

# Both files are read at the start of a shim resolution by a process that then

# execs the tool.

side_effect = false

# No machine_lines: a hook can be `{"bin": "…"}`, a command run to resolve a

# version, which would be machine-local when it names an absolute path — but it

# is just as often a bare command name, and a rule on the key would strand the

# `template`/`prefix` hooks that are exactly what a team wants shared.

[commands]

format = 1

label = "Volta"

description = "JavaScript tool manager. Forms cover install and pin."

quality = "ai-draft"

base = "fig:volta"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/volta.ts"

license = "MIT"

[[commands.subcommand]]

path = ["install"]

label = "Install tool"

description = "Install tools into your toolchain."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/volta.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "tools"

label = "Tools"

description = "tool@version, e.g. node@20."

type = "string"

position = 0

multiple = true

min = 1

suggestions = [{ value = "node@lts", label = "node@lts" }, { value = "node@20", label = "node@20" }, { value = "yarn@1", label = "yarn@1" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "verbose"

label = "Verbose"

type = "boolean"

option = ["--verbose"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "quiet"

label = "Quiet"

type = "boolean"

option = ["--quiet"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "install"

label = "Install"

fields = ["tools"]

required = ["tools"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["tools"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["verbose", "quiet"]

[[commands.subcommand]]

path = ["pin"]

label = "Pin tool"

description = "Pin the project's runtime or package manager."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/volta.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "tools"

label = "Tools"

description = "tool@version, e.g. node@20."

type = "string"

position = 0

multiple = true

min = 1

suggestions = [{ value = "node@lts", label = "node@lts" }, { value = "node@20", label = "node@20" }, { value = "yarn@1", label = "yarn@1" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "verbose"

label = "Verbose"

type = "boolean"

option = ["--verbose"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "quiet"

label = "Quiet"

type = "boolean"

option = ["--quiet"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "pin"

label = "Pin"

fields = ["tools"]

required = ["tools"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["tools"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["verbose", "quiet"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/volta. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.