What’s New?

The highlights of the current Exosphere release are below. For the complete history of past releases, see the Release Notes in the Reference section.

3.0.1 - Bugfix Release

A few minor edge case bugfixes, and documentation improvements that were long overdue and missed the window for 3.0.

The CLI Command Reference section of the documentation, in particular, has been overhauled and looks much nicer now.

Some minor refactoring on internals were also performed to improve code quality and internal API robustness.

Bug Fixes

  • Fixed issue during TUI app initialization where debug logs would be discarded and warnings would fail to display correctly.

  • Fixed Issue where SystemError: buffer overflow was encountered during CLI tasks on Python 3.14 in some specific circumstances, due to an upstream Fabric bug.

  • Exception system should now consistently report authentication failures within user facing UI elements, instead of sometimes showing the generic Paramiko message “Private key file is encrypted”.

Documentation

  • Refresh README to cover 3.0+ project structure

  • Fix multiple grammar, structure and rendering issues

  • Update the Documentation index to be in sync with the README

  • Document cache file locking mechanics in the appropriate section

  • Fix issue with CLI Command Reference linking to wrong section anchors for subcommands sharing a name

  • Improve presentation of string literal boxes throughout the documentation

  • Overhaul visual structure of the CLI Command Reference section.

What’s Changed

  • Migrate codebase to ruff 0.16+ linting rules

  • Add proper logger instance to textual app module

  • Normalize Configuration load errors to ValueError

  • Tests: do not patch logger where possible

  • Runners: Do not forward stdin to remote commands

  • Commands: use double backticks in docstrings

  • Move general exception handling to Host object

  • Docs: Fix minor grammar and render nits

  • Docs: explicitly name links where inlined

  • Docs: Fix command reference section anchors

  • Docs: Improve string literal CSS

  • Docs: Visually indent subcommands in CLI reference

  • Docs: Refresh documentation post 3.0 release