pinset init
Create a Pinset project configuration in the current directory to start managing its tool versions.
View source on GitHub ↗When to use
Use for a new project without .pinset/config.toml. To keep existing .nvmrc or similar declarations, use import without running init first.
Examples
pinset init
Result: creates .pinset/config.toml with a new project ID. Next, run pinset use node@24.
Behavior
Initializes the specified directory without importing version files, network access or tool installation. Unselected tools can inherit global defaults; project selections win. [policy] require_project_tools = true requires project selections. Broken project state or an unavailable selected tool remains an error. See core concepts.
Parameters, exit codes and common errors
No command-specific options. Success exits 0. Existing configuration exits 1 with PINSET_PROJECT_EXISTS; use that project or choose another directory.