Project and selection commands
pinset import
Re-scan and import every safe traditional selection into schema 4 pinset.toml and schema 3 pinset.lock.
View source on GitHub ↗| Field | Description |
|---|---|
| Purpose | Re-scan and import every safe traditional selection into schema 4 pinset.toml and schema 3 pinset.lock. |
| Syntax and arguments | pinset import [--cwd <path>] [--force] [--no-install]. --force replaces only discovered tools whose existing requested selector differs. |
| Modifies state | Yes. Resolves metadata, atomically replaces the lock file and then the config file, and installs all project selections by default. --no-install skips runtime archives and Python .venv, but still resolves and locks metadata. |
| Example | pinset import --no-install |
| JSON | No. |
| Exit | 0 after a complete import/install; 2 for no selection, blockers, invalid existing Pinset state, resolution/write failure, or installation failure. |
| Key errors | Conflicting sources, unsupported values, missing/mismatched existing lock, version replacement without --force, or unavailable Provider metadata. |
Import never reads installed state from another runtime manager, executes manager tasks/hooks, or deletes legacy files. If installation fails after the state commit, the valid config and lock remain and pinset install --locked resumes installation.
/en/docs/commands/importPinset 2.1