Command Reference
Complete reference for all scoop commands.
Commands Overview
| Command | Aliases | Description |
|---|---|---|
scoop list | ls | List virtualenvs or Python versions |
scoop create | - | Create virtualenv |
scoop use | - | Set + activate environment |
scoop remove | rm, delete | Remove virtualenv |
scoop install | - | Install Python version |
scoop uninstall | - | Uninstall Python version |
scoop doctor | - | Diagnose installation |
scoop info | - | Show virtualenv details |
scoop status | - | Summarise the currently active env |
scoop which | - | Resolve an executable inside an env |
scoop run | - | Run a command inside an env without activating |
scoop sync | - | Apply .scoop.toml declaratively |
scoop export | - | Write a portable JSON snapshot of an env |
scoop import | - | Recreate an env from an export file (or stdin) |
scoop clone | - | Duplicate an env (with or without packages) |
scoop migrate | - | Migrate from pyenv/conda/venvwrapper |
scoop gc | - | Garbage-collect orphan virtualenvs |
scoop prune | - | Prune the uv cache |
scoop verify | - | Per-env health diagnosis (6 checks) |
scoop lang | - | Get/set display language |
scoop shell | - | Set shell-specific env (temporary) |
scoop init | - | Shell init script |
scoop completions | - | Completion script |
scoop man | - | Generate man pages (for distro packagers) |
Global Options
Available for all commands:
| Option | Description |
|---|---|
-q, --quiet | Suppress all output |
--no-color | Disable colored output |
-h, --help | Show help message |
-V, --version | Show version |
Environment Variables
| Variable | Description | Default |
|---|---|---|
SCOOP_HOME | Base directory for scoop | ~/.scoop |
SCOOP_NO_AUTO | Disable auto-activation | (unset) |
SCOOP_LANG | Display language (en, ko, ja, pt-BR) | System locale |
NO_COLOR | Disable colored output | (unset) |
Directory Layout
| Location | Purpose |
|---|---|
~/.scoop/virtualenvs/ | Virtual environments storage |
~/.scoop/version | Global default environment |
.scoop-version | Local environment preference |
.venv | Symlink to active environment (with --link) |