envoic 0.0.8

Discover and report Python virtual environments on your system

---

Discover Python virtual environments and Python disk artifacts in a compact terminal layout.

[!WARNING] envoic is still experimental and therefore subject to major changes across releases. Breaking changes may occur until v1.0.0.

Installation

$ uv tool install envoic

# or

$ pipx install envoic

Run without installing:

$ uvx envoic scan .

Sample Outputs

1. Scan

Scan the current directory for Python virtual environments and artifact directories/files (__pycache__, .mypy_cache, .tox, dist/, build/, and more). Use --depth to control recursion and --deep to include size metadata.

2. List

List discovered Python virtual environments in a compact table.

3. Info

Get the information about the Python virtual environment in the current directory.

4. Manage

Interactively select environments and delete the selected ones with confirmation.

5. Clean

Delete stale environments in batch mode (supports --dry-run and confirmation).

Usage

$ envoic scan [PATH]
$ envoic scan ~/projects --deep
$ envoic scan ~/projects --no-artifacts

$ envoic list [PATH]

$ envoic manage [PATH]

$ envoic clean [PATH]

$ envoic info <ENV_PATH>

$ envoic version

Read more at Documentation

Local Development

$ uv sync --group dev

$ uv run pytest

$ uv run python -m envoic.cli scan . --deep --path-mode name

License

MIT