dotenvhub

dotenvhub is a terminal user interface application that centralizes management of .env files across multiple projects. It stores environment variable files in a central location following XDG Base Directory Specification standards, allowing developers to organize and access project-specific configurations without cluttering individual project directories.

The tool provides both a graphical TUI (launched with dot) and CLI commands for .env file operations. Users can create, edit, and delete environment files through the interface, with simple navigation enhanced by textual-jumper for quick file selection. The application automatically saves shell preferences via a config file and supports three deployment methods: copying shell-specific export commands to clipboard, creating file copies in the current working directory, or copying file paths for use with tools like python-dotenv.

The tool targets developers following 12-factor application principles who need to manage environment variables across multiple projects. It uses pyperclip for clipboard operations and may require additional packages like xclip or xsel on Linux systems. The centralized approach helps maintain clean project directories while ensuring environment configurations remain accessible and organized.

Installation

# via pipx
pipx install dotenvhub

# via uv
uv tool install dotenvhub

# via pip
python -m pip install dotenvhub