Managing Environments

envoic manage provides an interactive checklist for deleting virtual environments.

Interactive delete flow

envoic manage ~/projects

Flow:

1. scan for environments
2. select entries to delete (checkbox UI)
3. review deletion summary
4. type delete to confirm
5. delete selected directories with progress output

This command is intentionally conservative and requires explicit confirmation.

Example (manage)

Safety guarantees

• never deletes without explicit confirmation (unless --yes is provided)
• validates selected paths are inside the original scan root
• if selected path is a symlink, removes only the symlink (not target)
• handles permission failures per environment and continues
• supports --dry-run preview mode

Useful options

envoic manage . --stale-only
envoic manage . --stale-days 180
envoic manage . --deep
envoic manage . --dry-run
envoic manage . --yes   # caution: skips final typed confirmation

Non-interactive stale cleanup

Use clean for batch deletion of stale environments:

envoic clean ~/projects
envoic clean ~/projects --stale-days 180 --dry-run
envoic clean ~/projects --yes

Example (clean)