Command Reference

Complete reference for all scuv commands.

Commands Overview

Command	Aliases	Description
`scuv list`	`ls`	List virtualenvs or Python versions
`scuv create`	-	Create virtualenv
`scuv use`	-	Set + activate environment
`scuv remove`	`rm`, `delete`	Remove virtualenv
`scuv install`	-	Install Python version
`scuv uninstall`	-	Uninstall Python version
`scuv doctor`	-	Diagnose installation
`scuv info`	-	Show virtualenv details
`scuv status`	-	Summarise the currently active env
`scuv which`	-	Resolve an executable inside an env
`scuv run`	-	Run a command inside an env without activating
`scuv sync`	-	Apply `.scuv.toml` declaratively
`scuv export`	-	Write a portable JSON snapshot of an env
`scuv import`	-	Recreate an env from an export file (or stdin)
`scuv clone`	-	Duplicate an env (with or without packages)
`scuv migrate`	-	Migrate from pyenv/conda/venvwrapper
`scuv gc`	-	Garbage-collect orphan virtualenvs
`scuv prune`	-	Prune the uv cache
`scuv verify`	-	Per-env health diagnosis (6 checks)
`scuv lang`	-	Get/set display language
`scuv shell`	-	Set shell-specific env (temporary)
`scuv init`	-	Shell init script
`scuv completions`	-	Completion script
`scuv man`	-	Generate man pages (for distro packagers)
`scuv self update`	-	Reinstall scuv from crates.io (update or pin version)

Global Options

Available for all commands:

Option	Description
`-q`, `--quiet`	Suppress all output
`--color <WHEN>`	When to use color: `auto` (default; on a terminal unless `NO_COLOR` is set), `always`, `never`
`--no-color`	Same as `--color never`
`-h`, `--help`	Show help message
`-V`, `--version`	Show version

Environment Variables

Variable	Description	Default
`SCUV_HOME`	Base directory for scuv	`~/.scuv`
`SCUV_NO_AUTO`	Disable auto-activation	(unset)
`SCUV_LANG`	Display language (en, ko, ja, pt-BR, es)	System locale
`NO_COLOR`	Disable colored output when set to any non-empty value (an explicit `--color always` still colors)	(unset)
`SCUV_VERSION`	Shell-session override; highest-priority version selector (set by `scuv shell`)	(unset)
`SCUV_ACTIVE`	Name of the currently active environment (set by the activation script; read by `status`/`which`/`run`)	(unset)
`SCUV_RESOLVE_MAX_DEPTH`	Caps the parent-directory walk when resolving `.scuv-version` (0 = current dir only; unset = unlimited)	(unset)

Directory Layout

Location	Purpose
`~/.scuv/virtualenvs/`	Virtual environments storage
`~/.scuv/version`	Global default environment
`.scuv-version`	Local environment preference
`.venv`	Symlink to active environment (with `--link`)