Heroshot CLI vows to end mkdocs screenshot purgatory: auto light/dark swaps so your docs don't embarrass the whole team in dark mode

Developers using MkDocs with the Material theme can now easily keep their screenshots up to date with Heroshot, a command-line interface that captures and handles light and dark mode variants automatically. Heroshot can be installed via curl, Homebrew, npm, or Docker, and a Python package provides a MkDocs macro. To use Heroshot, users create a configuration file and run the CLI, which opens a browser for visual picking and naming of screenshots. The tool generates two files per screenshot, one for light mode and one for dark mode, and updates can be made by simply re-running the Heroshot command. The macro expands to Material's syntax, allowing screenshots to swap automatically when readers toggle the theme. Heroshot is particularly useful for developers who need to maintain documentation with screenshots, saving time and effort by automating the process, and is available for use with example documentation and integrations on the Heroshot website and GitHub repository.