dotenvhub

dotenvhub is a terminal-based application that centralizes the management of .env files across multiple projects. It stores environment variable files in a central location following the XDG Basedir Specification, allowing developers to organize and access project-specific configurations from a single hub rather than scattering .env files throughout individual project directories.

The tool provides both a graphical TUI interface launched with the dot command and CLI operations for automated workflows. Users can create, edit, and delete .env files through the interface, which includes navigation enhancements via textual-jumper for quick file selection. The application supports three deployment methods: copying shell-specific export commands to the clipboard, creating file copies in the current working directory, or copying file paths for use with libraries like python-dotenv.

The tool automatically saves the user's preferred shell configuration and organizes files under standard user data directories. It integrates with system clipboard functionality through pyperclip, though Linux users may need to install additional packages like xclip or xsel. This centralized approach helps developers follow 12-factor app principles by maintaining clear separation between configuration and code across multiple projects.

Installation

# via pipx
pipx install dotenvhub

# via uv
uv tool install dotenvhub

# via pip
python -m pip install dotenvhub