python

---

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.

Use Immediately

Run without installing:

uvx envoic scan .

NOTE: JavaScript version is available as npx envoic scan . - see JavaScript

Install:

uv tool install envoic

# or

pipx install envoic

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