Discover Python virtual environments and Python disk artifacts in a compact terminal layout.
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
Metadata
Release files for envoic 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| envoic-0.3.1.tar.gz | 47.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| envoic-0.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 71.3 kB
Release files / envoic-0.3.1.tar.gz
| Download URL | envoic-0.3.1.tar.gz |
|---|---|
| Size | 47.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b7f2fa8d250f52e7bd2c385e2f490a8ac253fd8fb44de081b392f36b4c22719
|
|
BLAKE2b-256 checksum How to use checksums |
01359bef923b62f42cbaaabfc7bd47d18e237872b1906b8adb74bea3d8095313
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / envoic-0.3.1-py3-none-any.whl
| Download URL | envoic-0.3.1-py3-none-any.whl |
|---|---|
| Size | 23.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d45f67bf9b0219340bcb3b3655419a5499bddec49c3a5209f46f7b20f96d929
|
|
BLAKE2b-256 checksum How to use checksums |
434a83da10cfa868151b914d2a4b2e78b5312166ef4b9429336e4c3987900804
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|