Tool management

`pinset list`

View project choices and local installations, or look up official available versions.

When to use

Use to see choices and disk installations. Find an entry with which; inspect health with check.

Examples

pinset list
pinset list node --remote

Illustrative first output:

Selected tools (exact lock)
  node  24.0.0  (24)
Installed
  node  24.0.0  linux-x86_64  /example/pinset/v3/installs/...

Behavior

Local listing is read-only, without tool execution or network access. --remote queries built-in Provider metadata, not SDK downloads. Generic tools cannot discover versions remotely. Install records do not prove a version probe passed.

Parameters, exit codes and common errors

Parameter	Meaning
`[tool]`	Filter one tool.
`--remote`	Query remote versions; requires a tool name.

Success exits 0; state or network errors exit 1; a missing required tool argument exits 2. Omit --remote to inspect local records during network failures.

/en/docs/commands/listDocumented version · Pinset 3.1.0