Command reference
29 commands documented for Pinset 3.1.0. Find the command for your task, then see examples, results, and options.
Start here
Start a new project
Create the configuration, then choose tool versions.
Migrate existing versions
Review the import plan, then install the imported tools.
Clone a Pinset project
Restore from the lockfile, then check the toolchain.
Tool management
9pinset initCreate a Pinset project configuration in the current directory to start managing its tool versions.→pinset importMigrate existing project version declarations into Pinset after reviewing a plan of the changes.→pinset useSelect or change project tool versions, update configuration and lock, and install the selected tools by default.→pinset installInstall tools from the project lock so a new computer or CI can restore the agreed toolchain.→pinset removeRemove a project tool choice while keeping downloaded tools and Python environments.→pinset listView project choices and local installations, or look up official available versions.→pinset whichFind the program a command will run and, when requested, explain its version and selection source.→pinset checkCheck that tool configuration, installations and command routes agree, with optional payload and actual-version verification.→pinset execRun a command with the project toolchain and environment, preserving native output and exit status.→Environment and keys
13pinset env initCreate an encrypted profile for development, testing or another environment.→pinset env useChoose a profile for later commands, changing only this machine's project choice by default.→pinset env removeDelete an unused encrypted profile and clear defaults pointing to it.→pinset env listList project profiles or the variable names in one profile.→pinset env setAdd or update a profile variable while saving only ciphertext in project files.→pinset env unsetRemove one variable from an encrypted profile while retaining other values.→pinset env access requestGenerate a public request so a maintainer can authorize this machine or CI to read encrypted profiles.→pinset env access grantAuthorize a collaborator or CI to read a profile using its public request.→pinset env access revokeRemove a profile grant and re-encrypt for the remaining recipients.→pinset env access listView public access grants registered for an environment profile.→pinset env trust addTrust reviewed project configuration and encrypted profiles locally so they can be decrypted and edited.→pinset env trust statusCheck whether this machine's trust in the current project is still valid.→pinset env trust revokeRevoke this machine's trust in the current project to stop subsequent encrypted environment use.→Cleanup
2Pinset maintenance
5pinset self infoView Pinset's current version, platform and paths for setup checks or issue reports.→pinset self shellGenerate a PATH snippet so your shell can run Pinset-managed tool commands directly.→pinset self completionsGenerate shell completion scripts to make Pinset commands and options easier to enter.→pinset self repairRecover interrupted Pinset operations and repair Pinset-managed command entries.→pinset self updateUpdate Pinset from official releases or install an explicitly selected Pinset 3 version.→