Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Command Reference

Complete reference for all scoop commands.

Commands Overview

CommandAliasesDescription
scoop listlsList virtualenvs or Python versions
scoop create-Create virtualenv
scoop use-Set + activate environment
scoop removerm, deleteRemove 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:

OptionDescription
-q, --quietSuppress all output
--no-colorDisable colored output
-h, --helpShow help message
-V, --versionShow version

Environment Variables

VariableDescriptionDefault
SCOOP_HOMEBase directory for scoop~/.scoop
SCOOP_NO_AUTODisable auto-activation(unset)
SCOOP_LANGDisplay language (en, ko, ja, pt-BR)System locale
NO_COLORDisable colored output(unset)

Directory Layout

LocationPurpose
~/.scoop/virtualenvs/Virtual environments storage
~/.scoop/versionGlobal default environment
.scoop-versionLocal environment preference
.venvSymlink to active environment (with --link)