Changelog#

2026-05-06 0.2.0:#

Enhancements#

Add conda self reset to restore the base environment to its installer-provided or post-migration state. (#54, #55 via #83)
Add --all flag to conda self update to update conda, all plugins, and all dependencies. (#37 via #79, #80 via #84)
Add --yes support to conda self remove and conda self update subcommands. (#108)
Add support for removing non-essential plugins with conda self remove, including a --force flag to override permanent package protection. (#95, #127)
Register base-protection health check for conda doctor --fix. (#88)
Add configurable self_permanent_packages setting. (#116)
Reject channel specs in conda self install (use .condarc instead). (#118)
Split --snapshot installer into installer-exact and installer-updated. Auto-fallback prefers installer-updated and no longer downgrades installer-provided packages like mamba in Miniforge installs. (#121)
Build canary packages on merge to main. (#90)

Bug fixes#

Fix conda self install bypassing frozen environment protection. (#119)
Fix SpecsAreNotPlugins error for wheel-based conda plugins. (#106)
Fix missing context import in query.py. (#128)

Docs#

Overhaul documentation with Diátaxis structure (tutorials, how-to guides, reference, explanation). (#120)
Add 6 VHS terminal demos: quickstart, install-plugin, base-protection, update, remove, reset. (#120)
Document custom channel configuration for plugin install. (#117)
Document how to unprotect the base environment. (#115)

Other#

Remove conda migrate subcommand. (#91)
Bump minimum Python version to 3.10. (#82)
Add Python 3.14 to test matrix. (#109)
Speed up test suite with session-scoped environments. (#129)
Require conda 25.5.0+. (#63)

Contributors#

@jezdez
@kenodegard
@marcoesters

2025-07-21 0.1.1:#

Bug fixes#

Fix conda self protect and conda self remove help text. (#17)

Contributors#

@kenodegard

2025-07-17 0.1.0:#

Initial release:

$ conda self -h
usage: conda self [-V] [-h] {install,protect,remove,reset,update} ...
Manage your conda 'base' environment safely.

options:
  -V, --version         Show the 'conda-self' version number and exit.
  -h, --help            Show this help message and exit.

subcommands:
  {install,protect,remove,reset,update}
    install             Add conda plugins to the 'base' environment.
    protect             Remove conda plugins from the 'base' environment.
    remove              Protect 'base' environment from any further modifications
    reset               Reset 'base' environment to essential packages only.
    update              Update 'conda' and/or its plugins in the 'base' environment.

Contributors#

@jaimergp
@soapy1